caic-xyz docs

Appearance

caic ​

Coding Agents in Containers. Manage multiple AI coding agents running in parallel in isolated Docker containers. 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 isolated md containers, orchestrated through a unified web UI and Android app. Each task runs in its own container so agents never interfere with each other or your local checkout.

Platform support ​

caic is supported on Linux, macOS, and Windows via WSL2.

Key features ​

  • Parallel agents — run many agents simultaneously on different branches
  • Resilient sessions — server restarts don't kill running agents; a relay process inside each container keeps agents alive across SSH disconnects
  • Forge integration — automatic PR/MR creation and CI monitoring for GitHub and GitLab
  • Lightweight — single Go binary, low memory and CPU footprint
  • Web UI — SolidJS frontend embedded in the binary
  • 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

Screenshots ​

Interacting with an agent ​

Interacting with an agent

Plan mode ​

Plan mode

Ask mode — agent asks for user input ​

Ask mode

Widget — generative UI ​

Widget

Android app ​

Android task list

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, trade-offs, core principles
  • Security — authentication, credential handling, isolation model

Getting help ​