caic-xyz docs

Appearance

caic ​

Coding Agents in Containers. Manage multiple AI coding agents running in parallel in isolated containers powered by Docker or Podman. Access them from your phone with Tailscale. All private.

What is caic? ​

caic lets you run AI coding agents (Claude Code, Codex, OpenCode, Pi) in md containers, orchestrated through a unified web UI and Android app. Each task gets a separate container and repository copy, so agents do not edit one another's workspace or your local checkout. Shared agent and harness state, caches, and custom mounts remain common where configured.

Key features ​

  • Parallel agents: run many agents simultaneously on different branches
  • Flexible runtimes: use Docker and Podman side by side, then choose the runtime for each new task
  • Resilient sessions: server restarts don't kill running agents; a relay process inside each container keeps agents alive across SSH disconnects
  • Recoverable workspaces: fork a running, stopped, or crashed task with an editable handoff, or continue quota-blocked work with another available agent
  • Task visibility: inspect usage, cost, resource graphs, compact repository state, task commits, collapsible per-file diffs, and the native subagents a task's agent spawns
  • Keyboard navigation: open shortcuts with ? or F1, move through tasks with the arrow keys, use Tab to jump from a card to its prompt, and more.
  • Forge integration: automatic PR/MR creation and CI monitoring for GitHub and GitLab
  • Lightweight: single Go binary, low memory and CPU footprint
  • Voice control: supervise and steer agents hands-free with voice mode
  • MCP server: connect Claude or ChatGPT to your tasks through the MCP endpoint
  • Android app: voice-first companion app to manage agents from your phone
  • Runs on Linux, macOS, and Windows via WSL2.

Screenshots ​

Interacting with an agent ​

caic task view with streamed agent output, expanded tool calls, repository changes, CI status, and a message composer
Follow a task from setup through tool use and its final result.

Plan mode ​

caic task in plan mode showing a five-step implementation plan and an action to execute it
Review an agent's plan before allowing implementation to begin.

Ask mode ​

caic task asking the user to choose among three storage backends or provide another answer
Answer structured questions without leaving the task view.

Widget ​

caic task displaying an interactive diagram that explains light refraction in water
Agents can present interactive generative UI directly in a task.

Quick start ​

bash
curl -fsSL https://caic.xyz/install.sh | bash

See Installation for full setup, and Configuration for config file reference and service setup.

Documentation ​

  • Installation: prerequisites, platform notes, from-source builds
  • Configuration: config file reference, auth modes, HTTPS exposure
  • GitHub Integration: automatic PR creation and CI monitoring
  • GitLab Integration: automatic MR creation and CI monitoring
  • Voice: hands-free supervision with embedded, standalone, or fully local gateways
  • MCP Server: connect external MCP clients over OAuth
  • Android App: voice-first companion app
  • Architecture: system components, task lifecycle, relay, startup
  • Design: design rationale and core principles
  • Security: authentication, credential handling, isolation model

Getting help ​