Aidock

aidock

[](LICENSE) [](https://github.com/ruifm/aidock/actions/workflows/ci.yml) [](aidock)

Run AI coding agents (Copilot CLI, Claude Code, Codex) inside per-project, stateful Podman/Docker containers. One Bash script, no dependencies beyond the engine.

aidock              # launch your default agent in this project's container
aidock -a claude    # switch agent
aidock shell        # debug shell

Why

AI coding agents run with full access to your filesystem and credentials. aidock puts them in a container that:

• mounts only your project (same absolute path inside and out),
• forwards the agent's host auth and stable rule files (e.g. CLAUDE.md),
• commits the container on exit so installs (dnf, pip, npm -g) and self-updates persist per project.

Install

Requires [Podman](https://podman.io/docs/installation) (preferred) or Docker.

curl -fsSL https://raw.githubusercontent.com/ruifm/aidock/main/aidock -o ~/.local/bin/aidock
chmod +x ~/.local/bin/aidock

Or `git clone https://github.com/ruifm/aidock.git && cd aidock && just install`.

Quick start

cd my-project
aidock              # first run builds the base image (a few minutes)

aidock probes your host for each agent's auth and uses what you have:

Agent	Configured if any of
Copilot	GH_TOKEN set, or gh auth token succeeds, or ~/.config/github-copilot/hosts.json exists
Claude	ANTHROPIC_API_KEY set, or ~/.claude/.credentials.json exists
Codex	OPENAI_API_KEY set, or ~/.codex/auth.json exists

If only one is configured, aidock autoselects it. If two or more, it shows a TTY picker (unconfigured agents listed read-only with their setup hint). If none, aidock exits with hints:

| Agent | Setup | |----