corgi agent carry

Continue a session under another account, conversation and all

Synopsis

Moves a session to another of the workspace's accounts. For the session that hit its limit while the other account still has budget.

First it leaves a handoff for the ticket (corgi agent handoff): a draft from git and the last thing the session said, unless the session wrote its own. Then, by default, the transcript is copied into the other account's config directory and a new terminal in the same window runs corgi agent claude --profile <name> -- --resume <id>, so the conversation carries on where it was. With --fresh — or on its own when the context window is over 85% full — the new session starts clean instead, with the handoff as its first prompt: same worktree, none of the old context.

Only a profile the workspace's accounts: list names is allowed — a workspace that lists none cannot be carried anywhere. The old session is dismissed once the new one is up; its process is left alone.

--fork N opens N new sessions that all continue this one's conversation (claude --fork-session), each in its own terminal: one session that read the code once becomes several that build on the same context. --prompt, repeated, hands each fork its own first message, in order; forks past the last --prompt start with none. Without --profile the forks run under the session's own account. The original keeps running.

corgi agent carry k3 --fork 3 --prompt "do the api side" --prompt "do the web side" --prompt "write the tests"

corgi agent carry <session> --profile <name> [flags]

Options

      --fork int             Open this many sessions that all continue the conversation (2 to 8); the original keeps running
      --fresh                Start clean from the handoff instead of resuming the transcript (automatic past 85% context); without --profile, the same account
  -h, --help                 help for carry
      --profile string       The account (corgi profile) to continue under
      --prompt stringArray   First message for the next fork, in order; repeat once per fork

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 carry