corgi agent plan
corgi agent plan
A planner breaks a goal into tasks on the board; the daemon works through them, a worktree each
Synopsis
One goal, handed to a planner (a short claude run on this machine, sonnet by default) that writes 2–6 tasks on the board — what to change, where, how a session knows it is done, which tasks wait for which. Nothing runs until you say so; the tasks sit in Todo for you to read, edit (corgi agent task edit) or remove.
corgi agent plan "add rate limits to the public API" corgi agent plan "…" --workspace api --limit 4 corgi agent plan "…" --run --slots 2 start at once, two tasks side by side
Running (corgi agent plan run P-1): the daemon starts each task when its turn comes — the same unattended run a ticket gets, in a worktree of its own, the workspace's caps, quiet hours and breaker respected — and the next when one ends. A task that is Review (a pull request is up) or Done lets the ones after it start. A run that failed leaves its task for you; the plan does not retry it. The kanban shows the tasks; corgi agent plan status shows the plan.
The workspace must be watched (corgi agent watch enable --isolate) for the daemon to run anything.
corgi agent plan "<goal>" [flags]
Options
-h, --help help for plan
--max int at most this many tasks (2–12) (default 6)
--model string the planner's model: sonnet (default), opus, haiku
--run start working through the tasks at once
--slots int how many tasks run at once; more than one needs the workspace watched with --isolate (default 1)
--workspace string the workspace the plan is for (default: the one you are in)
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
- corgi agent - Keep Claude Code Remote Control running for your corgi workspaces
- corgi agent plan run - Start (or resume) working through a plan's tasks
- corgi agent plan status - Every plan and where its tasks stand
- corgi agent plan stop - Stop a plan: nothing more starts; its Todo tasks go to Canceled, a run already going finishes