ancha test

ancha test saves what an ancha agent run used, the agent, scenarios, data versions, attempts and seed, so you can run exactly the same thing after changing the agent. For playground tests, see ancha playground.

ancha test new

ancha test new [options] <intent>

Drafts a test from one sentence: who starts it, what ends it, and checks on what people learn, decide and are told. The draft is validated against the world before it’s written. It calls a model: your OPENROUTER_API_KEY, or your workspace’s model credit when you’re logged in.

Option	Description
`--world <id>`	World file in ancha/worlds (default: the only one)
`--id <id>`	Test id (default: from the sentence)
`--out <dir>`	Where to write the test (default: “ancha/tests”)
`--force`	Replace an existing test with the same id
`--idempotency-key <key>`	Return the first result for a repeated request instead of drafting again

ancha test save

ancha test save [options] <runId>

Option	Description
`--name <name>`	Saved test name

ancha test save run_20261031-075305_58f8f7611bae17ed --name "Starter access"

Output

Starter access: setup_b41cf0b5-ea57-446a-aef2-35b64ae190e7
Run again with ancha test run setup_b41cf0b5-ea57-446a-aef2-35b64ae190e7

ancha test list and show

ancha test list [options]

Output

setup_b41cf0b5-ea57-446a-aef2-35b64ae190e7  Starter access  1 scenarios × 2 attempts

ancha test show [options] <id>

Output

Starter access
ID: setup_b41cf0b5-ea57-446a-aef2-35b64ae190e7
Agent: Quickstart agent (agent:agent_2817abf5-f4bb-4cf3-9839-77309f18c2fc)
Scenarios: Discover the four local services
Attempts per scenario: 2
Parallel workers: 1
World seed: test-1
Inputs: pinned from run_20261031-075305_58f8f7611bae17ed
Run: ancha test run setup_b41cf0b5-ea57-446a-aef2-35b64ae190e7

ancha test run

ancha test run [options] <id>

Output

run_started runId=run_20261031-075317_ef7a7e5e915af358
run_20261031-075317_ef7a7e5e915af358: pass
Use ancha report or ancha explain to inspect the result.

Runs from clean worlds with your current agent code. If a scenario or its data changed since the test was saved, it refuses to start.

ancha test remove

ancha test remove [options] <id>

Deletes the saved setup and keeps its past runs.

Get started

Guides

Concepts

Tools

CLI

Reference

Cloud

Help

ancha test new

ancha test save

ancha test list and show

ancha test run

ancha test remove

​ancha test new

​ancha test save

​ancha test list and show

​ancha test run

​ancha test remove

ancha test new

ancha test save

ancha test list and show

ancha test run

ancha test remove