Skip to main content

corgi agent init

corgi agent init​

Opt this stack into agent mode

Synopsis​

Registers the current directory as an agent-mode workspace and writes .corgi/agent.yml.

That file is committed and holds identity only - id and aliases. Anything that grants capability (which binary runs, which Claude config directory, permission mode) lives in the user-level config instead, because a committed file arrives with a clone and is not written by whoever runs the daemon.

corgi agent init [flags]

Options​

--agents strings The agents to try in order, e.g. claude,codex: the next takes an unattended run when the first cannot
--alias strings Extra names this workspace answers to, e.g. --alias 'recipe app'
--config-dir string CLAUDE_CONFIG_DIR for this workspace, so it runs under a specific Claude account
--dangerously-skip-permissions Run this workspace's sessions with permission prompts OFF (--permission-mode bypassPermissions). Removes the gate you answer from your phone - off by default.
-h, --help help for init
--id string Workspace id (defaults to the directory name)
--kind string The one agent this workspace runs (claude, codex); --agents lists several
--sensitive Never open a public tunnel for this workspace

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 16-Nov-2026​