corgi agent handoff

Leave a typed handoff for the next run on this ticket

Synopsis

Writes .corgi/corgi_services/handoffs/<ref>.json and a Markdown twin in the workspace. corgi fills in where the code is (branch, head, base, uncommitted files), who is writing (session, account) and how much budget was left; you say what is done, what is not, what was decided and what to ask.

corgi agent handoff --ref ABC-123
--done "POST /limits returns 429" --done "regression test"
--remaining "web banner on 429"
--decision "5h sliding window, not fixed"
--uncertain "should the phone retry by itself?"
--next "web banner, then open the web PR"
--verify "corgi test --changed"

corgi agent handoff show ABC-123 # the Markdown twin corgi agent handoff list # every packet here, newest first corgi agent handoff verify ABC-123 # re-run its check at the current head corgi agent handoff rm ABC-123

--ref defaults to the ticket key in the branch name. --verify runs the command now and records its exit code and the head it ran on; the next run re-runs it before trusting the packet. A packet that names a secret or a TODO is refused.

corgi agent handoff [--ref ABC-123] --done … --remaining … --next … [flags]

Options

      --blocked string          the missing tool, credential or secret (sets state blocked)
      --decision stringArray    one call made, so the next run does not re-derive it (repeatable)
      --dir string              the workspace (default: the one containing the current directory)
      --done stringArray        one thing that is finished (repeatable)
  -h, --help                    help for handoff
      --model string            the model that did the work
      --next string             the first thing the next run should do
      --ref string              the ticket (default: the key in the branch name)
      --remaining stringArray   one thing that is not (repeatable)
      --session string          the board session writing this (default: the one in this directory)
      --state string            working, input-required, auth-required, completed, failed (default "input-required")
      --tracker string          the ticket's URL
      --uncertain stringArray   one thing to ask a person before assuming (repeatable)
      --verify string           a command to run now and record, e.g. "corgi test --changed"

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

corgi agent handoff