ruifm

Aidock — AI skill for Claude Code

AI community

Run AI coding agents in a container.

How to install Aidock

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ruifm/aidock and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Aidock does

Run AI coding agents in a container. Copilot CLI, Claude Code, Codex — one command, batteries included.

Alternatives in AI

CLI Continues — resume any AI coding session in another tool — Claude Code, Copilot, Gemini, Codex, Cursor 1.5k ★
Agmsg — Cross-vendor messaging for CLI AI coding agents — let Claude Code, Codex, Gemini & Copilot talk to each other 1.5k ★
onWatch — Open-source Go CLI that tracks AI API quota usage across 7 providers (Synthetic, Z.ai, Anthropic, Codex, GitHu 397 ★

README

aidock

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![CI](https://github.com/ruifm/aidock/actions/workflows/ci.yml/badge.svg)](https://github.com/ruifm/aidock/actions/workflows/ci.yml) [![Bash](https://img.shields.io/badge/language-bash-green.svg)](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 | |----