Skip to main content

corgi agent claude

corgi agent claude​

Run Claude Code the way this folder's workspace is configured

Synopsis​

Starts Claude Code for the workspace the current directory belongs to, under that workspace's account (configDir), binary and permission mode from the corgi agent config - the same settings a remote session gets. Outside every workspace it is plain claude. So one command replaces per-account aliases: the corgi VS Code extension's "+" key runs it in a new terminal.

corgi agent claude # this folder's workspace corgi agent claude --workspace api # that workspace, whatever folder you are in corgi agent claude --profile work # under a corgi profile corgi agent claude --profile auto # the listed account with most budget left corgi agent claude --model auto # the workspace's models: policy, else opusplan corgi agent claude --show # print the command instead of running it corgi agent claude -- --resume # arguments after -- go to claude

corgi agent claude [-- claude args] [flags]

Options​

--attempt int This session is attempt N of several on the same ticket (corgi agent watch work --attempts): its own worktree on corgi/<ticket>-N, and the board groups them
--bot string Open as this bot (corgi agent bot list): its workspace, account, model and persona, resuming its last conversation
-h, --help help for claude
--isolate Start in a worktree of its own on a corgi/<ticket> branch - every repository of the stack gets one - so this session never touches your checkout
--kind string Open this harness instead of the workspace's (claude, codex)
--model string Pass --model to claude (opus, sonnet, haiku, or a model id)
--profile string Run under this corgi profile's account and settings
--prompt-id string Start with the prompt saved under this id by the phone launcher; the file is read once and removed
--show Print the resolved command and exit
--ticket string The tracker ref(s) this session works on (ABC-1 or ABC-1,ABC-2): the board shows it on the ticket
--ticket-key string The inbox key of that ticket, with --ticket
--workspace string Start in this registered workspace's checkout, under its account, whatever folder 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
--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
Auto generated by spf13/cobra on 16-Nov-2026​