Skip to main content

​
Who is this for?

If you’ve just joined a team using Spur — or you are taking a look at tests someone else wrote — you may not know what test coverage already exists. Rather than clicking through the Spur dashboard to find out, you can ask your AI assistant to tell you. This workflow is especially useful when you:
  • Are new to a codebase and want to understand what’s already tested
  • Need to run tests for a feature you’re working on but aren’t sure what’s available
  • Want to quickly check if a specific flow has coverage before writing new tests

​
Walkthrough

1

Ask what tests exist

Start with a broad question like “What tests do I have?” or narrow it down: “What tests do I have for Adding to Cart?”Your agent calls list_tests to pull all tests in your active application, then filters by name and description to find relevant matches.
2

Choose the Tests

The agent returns a list of matching tests with their IDs, suites, and descriptions. You can ask follow-up questions like “What does the checkout test cover?” to get full step details via get_test_details.
3

Run tests directly

Once you’ve found the right test, tell your agent to run it: “Run this on staging.”The agent calls run_test with the correct environment and configuration, then monitors the run status. The agent will prompt you to fill in any configurations that it is missing.
4

Review results

When the run completes, ask “How did it go?” The agent calls get_test_run_overview to summarize the results — passing steps, failures, and warnings — so you can decide what to do next.