Agents

Asylum is primarily built and tested with Claude Code. Gemini CLI and Codex support is experimental — basic functionality works, but these agents receive less testing and may have rough edges.

All agents run in YOLO mode (auto-approve all actions) by default.

Supported Agents

Agent	Binary	Default Mode	Config Dir
Claude Code	claude	--dangerously-skip-permissions	~/.claude
Gemini CLI	gemini	--yolo	~/.gemini
Codex	codex	--yolo	~/.codex

Selecting an Agent

asylum                # Claude Code (default)
asylum -a gemini      # Gemini CLI
asylum -a codex       # Codex

Or set it in your config:

agent: gemini

Config Isolation

Asylum controls how each agent's config directory is managed inside the container. Three modes are available: shared (host config mounted directly), isolated (default — separate copy in ~/.asylum/agents/<agent>/), and project (per-project copy).

On first run with Claude, Asylum prompts you to choose a mode. See Config Isolation for full details.

Passing Extra Args

Use -- to pass flags to the agent:

asylum -- --verbose
asylum -a gemini -- --sandboxed

Resume Behavior

Each agent resumes its previous session by default. Use -n to start fresh. See Sessions for details on how each agent detects previous sessions.

Installing Multiple Agents

By default, only Claude Code is installed in the base image. To install additional agents:

agents:
  claude: {}
  gemini: {}
  codex: {}

Or via CLI:

asylum --agents claude,gemini

Agent installation requires their kit dependencies (Gemini and Codex need the node kit).