Skip to main content

corgi agent scenario

corgi agent scenario​

End-to-end stories a change is judged against, kept where the session building it does not look

Synopsis​

An agent that can read its tests can pass them without doing the work. A scenario is a story kept outside every repository, in the agent directory. A separate run reads it, tries the behaviour with read-only tools, and says whether a person would be satisfied. The result is a share, not a green tick.

corgi agent scenario add refund --text "A customer who paid yesterday asks for a refund, and sees it on their statement page." corgi agent scenario add checkout --file checkout.md corgi agent scenario list corgi agent scenario run every scenario, once, on what is checked out here corgi agent scenario run --dir <worktree> --times 3 --min 90 corgi agent scenario rm refund

The builder's words back are only the judge's one line on what it saw. A session on this machine could still open the folder if it went looking: this keeps scenarios out of its way, it is not a lock.

Options​

-h, --help help for scenario

Options inherited from parent commands​

--describe Describe contents of corgi-compose file
--dockerContext string Specify docker context to use, can be default,orbctl,colima (default "default")
-l, --exampleList List examples to choose from. Click on any example to download it
-f, --filename string Custom filepath for for corgi-compose
--fromScratch Clean the .corgi/corgi_services folder before running
-t, --fromTemplate string Create corgi service from template url
--fromTemplateName string Create corgi service from template name and url
-g, --global Use global path to one of the services
--interactive Force interactive prompts even when no TTY/agent detected
--isolate string Run this workspace under a named lease: own port block, own database names, own containers
--json Emit machine-readable JSON output
--privateToken string Private token for private repositories to download files
-o, --runOnce Run corgi once and exit
--silent Hide all welcome messages

SEE ALSO​

Auto generated by spf13/cobra on 16-Nov-2026​