Skip to content

CLI Options

Stefan Kuhn edited this page Feb 3, 2026 · 11 revisions

CLI options

Core options

  • --dry-run: print the composed docker run command without executing it.
  • --docker: mount /run/docker.sock into the container to enable Docker-in-Docker workflows.
  • --share <path>: mount a host path into the container at the same path. Repeatable; append :ro for read-only. Missing paths are created (file if a suffix is present, otherwise a directory).
  • --config print: print the project config path and its contents.

Info

  • -h, --help: show usage and exit.
  • --version: print the aicage version and exit.

Examples

Print the docker command without running it (replace <agent> with your agent):

aicage --dry-run <agent>

Mount the Docker socket for Docker-in-Docker:

aicage --docker <agent>

Share a host directory into the container (read-only):

aicage --share /data:ro <agent>

Show the project config path and contents:

aicage --config print

Clone this wiki locally