corgi agent codex

Run Codex the way this folder's workspace is configured

Synopsis

Starts Codex for the workspace the current directory belongs to, in its checkout and under its settings - corgi agent claude with another harness. The session lands on the board once corgi agent track enable has written Codex's notify hook.

corgi agent codex # this folder's workspace corgi agent codex --workspace api # that workspace, whatever folder you are in corgi agent codex --show # print the command instead of running it corgi agent codex -- --model o3 # arguments after -- go to codex

corgi agent codex [-- codex 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 codex
      --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
      --model string        Pass --model to codex (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 codex