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​

      --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)
      --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 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 31-Aug-2026​