Skip to main content

corgi agent container

corgi agent container​

Run the agent daemon in a Docker container, here or on a server over ssh

Synopsis​

The same loop as on a laptop - the daemon, the watch, the routines, the headless fixes, the phone through a tunnel - in a container on any Docker host. The image has corgi, Claude Code, git, gh and the docker CLI; the agent dir, the clones and the Claude login live in volumes.

corgi agent container up # build + start here corgi agent container up --host ssh://me@build-1 # on a server (its Docker, its volumes) corgi agent container up --clone git@github.com:acme/stack.git --docker corgi agent container shell # a shell inside: corgi agent watch enable ... corgi agent container logs | stop | down | status

up asks once for a Claude token (claude setup-token prints one) and keeps it in the container's env file. --docker mounts the host's Docker socket so a fix can run the stack. The files are written under the agent dir (container/) - edit the Dockerfile or compose.yml there and run up again.

corgi agent container [up|shell|logs|stop|down|status] [flags]

Options​

--clone string A git URL the container clones to /work/stack and registers at first start
--docker Mount the host's Docker socket so fixes can run the stack
-h, --help help for container
--host string Docker host to build and run on, e.g. ssh://me@build-1 (DOCKER_HOST)

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​