Skip to main content
ancha runs works with the runs your workspace holds: the results you upload from this computer, and the playground runs the workspace runs itself. Every subcommand takes --json, and every object it prints names its workspace.

​
ancha runs upload

Sends a run that already finished on this computer to your workspace, where the console shows it. Use it when a run was made without --upload, when an upload failed, or after the fact in CI.
Output
With --json, the result is {"runId", "workspace", "upload": {"url", "bytes", "files", "replaced"}}. Uploading a run again replaces its copy in the workspace, and replaced is true. It needs a workspace: ancha login, or ANCHA_SERVER_URL and ANCHA_API_KEY. Without one it exits 2 with --upload needs a workspace. See Results in your workspace for what the upload holds.

​
ancha runs list

Lists the workspace’s playground runs, newest first, with their status, grade and queue position.

​
ancha runs show

Shows one run with its attempts and grade. A run_… ID or latest reads a run on this computer. ancha attempt show <run> <attempt> prints one attempt’s response, calls and final tool data.

​
ancha runs start

Runs one test with a saved agent in fresh worlds. In a hosted workspace the console runs it, so a dropped connection does not stop it; ancha runs show <id> picks it up. Running your own agent in the workspace is in private beta: until your workspace has access, the command is refused with hosted runs of your own agent are in private beta for this workspace. With --local, the run happens on this computer with the project’s own agents and worlds, and --no-wait is a usage error.

​
Where the commands run

With a hosted workspace, from ancha login or ANCHA_SERVER_URL, ancha runs list, show and start work on that workspace’s runs, the same ones the console shows. --local keeps them on this project’s .ancha/. ancha runs upload always sends to the workspace.

​
Exit codes

0. 2 for an unknown run, a test without a task, no workspace for upload, or --no-wait without a hosted workspace. 3 when the workspace cannot be reached or does not answer the upload; ancha runs upload <run id> tries again.