corgi agent bot
corgi agent bot
Named sessions you come back to: a workspace, a persona, a model, a thread
Synopsis
A bot is who you talk to; a session is the process. Give a bot a name, a workspace, a persona (its "soul", appended to Claude Code's system prompt), a model and an account, and open it from the phone, the menu bar, the editor or here: it starts in that workspace as that persona and resumes the conversation it last had.
corgi agent bot add reviewer --workspace api --title "Code Reviewer"
--soul "You review pull requests. Read the diff, run the tests, be brief."
--model opus --profile work --color orange
corgi agent bot open reviewer # in the editor window in front
corgi agent claude --bot reviewer # in this terminal
A bot can also act on its own: --on names the events it runs on when they arrive in its workspace, as an unattended run under its soul.
corgi agent bot add reviewer --template reviewer --workspace api corgi agent bot add fixer --on ci.failed --soul "…" --workspace api corgi agent bot show reviewer # what it is, what it did
Options
-h, --help help for bot
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 bot add - Add or replace a bot
- corgi agent bot list - Every bot on this machine
- corgi agent bot open - Open a bot in the editor window in front (the '+' key, as that bot)
- corgi agent bot rm - Remove a bot (its conversations stay in Claude Code)
- corgi agent bot show - What a bot is, what it does on its own, and what it has done