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

corgi agent claude