Skip to main content

corgi agent cap

corgi agent cap

A token budget for every session, or for one

Synopsis

Every session carries what it has spent — the token counts Claude Code writes in its transcript, summed on the daemon's sweep — and a budget. "corgi agent cap 50M" is the budget every session runs under; "corgi agent cap <session> 20M" gives one session its own. The daemon rings once when a session passes it and the row says "over budget" on every board; nothing is stopped. "off" takes a budget away. No argument prints the default.

corgi agent cap [<session>] <tokens|off> [flags]

Options

-h, --help help for cap
--repo string A tokens-per-day budget for this workspace instead: corgi agent cap --repo api 20M

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

SEE ALSO

  • corgi agent - Keep Claude Code Remote Control running for your corgi workspaces
Auto generated by spf13/cobra on 20-Sep-2026