Skip to main content

corgi agent guard

corgi agent guard

A pre-push hook that refuses a branch whose session's gate or tests are red

Synopsis

Installs a git pre-push hook in this checkout. On every push the hook asks the board about the branch: a session on it whose done-when gate is red, or whose last test run went red, stops the push and says which command failed. A branch with no session on it is not the guard's business. CORGI_FORCE=1 git push goes through anyway.

corgi agent guard install # this checkout corgi agent guard uninstall corgi agent guard check # what the hook runs; exit 1 = refused

corgi agent guard [install|uninstall|check] [flags]

Options

--force Replace a pre-push hook that is not corgi's
-h, --help help for guard

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