CLI Options

CLI options

Core options

• --dry-run: print the composed docker run command without executing it.
• --menu textual|simple|none: use the Textual configuration UI, the classic line-based prompt menu, or no menu.
• --docker: mount /run/docker.sock into the container to enable Docker-in-Docker workflows.
• --share <path>: mount a host path into the container. Repeatable; append :ro for read-only.
• Extensions can also define extra shares (host mounts).
• --config: print the project config path and its contents.
• --config remove [<agent>]: remove the whole project config file, or only one agent entry.

Proxy env forwarding

When set on the host, aicage forwards these proxy env vars to local image builds and runtime: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and NO_PROXY.

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>

Use the default Textual configuration UI:

aicage <agent>

Use the classic line-based prompt menu:

aicage --menu simple <agent>

Run without menus and accept defaults:

aicage --menu none <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

Remove only the codex entry from the project config:

aicage --config remove codex