Clincus¶
Secure and fast container runtime for AI coding tools on Linux.
Run Claude Code, GitHub Copilot CLI, opencode, and other AI assistants in isolated Incus containers with session persistence, a web dashboard, and resource limits.
Features¶
| Feature | Description |
|---|---|
| Container isolation | Each session runs in its own Incus container, fully isolated from your host |
| Session persistence | Save and resume AI conversations with full history across container restarts |
| Web dashboard | Launch and manage sessions from your browser with a built-in Svelte SPA |
| Multi-tool support | Claude Code, GitHub Copilot CLI, opencode, and custom tools configurable per project |
| Workspace mounting | Project files are bind-mounted into containers with UID-shifting for security |
| Snapshots | Checkpoint and rollback container state for safe experimentation |
| Resource limits | CPU, memory, disk I/O, and time limits per session |
| File transfer | Push and pull files between host and containers with clincus file |
Quick Start¶
# Build the container image (one-time setup)
clincus build
# Start a Claude Code session in the current directory
clincus shell
# Start an opencode session in a specific workspace
clincus shell --tool opencode ~/my-project
# List active sessions
clincus list
# Open the web dashboard
clincus serve --open
Navigation¶
Getting Started¶
New to Clincus? Start here.
- Prerequisites — system requirements and Incus setup
- Installation — install from release or build from source
- Quick Start — build your first image and run a session
Guides¶
Task-oriented documentation for common workflows.
- Sessions — session lifecycle, persistence, and multi-slot usage
- Workspaces — workspace mounting and file transfer
- Web Dashboard — browser-based session management
- Tools — configuring Claude Code, Copilot, opencode, and custom tools
- Images — building and customizing container images
- Snapshots — checkpointing and rolling back container state
- Resource Limits — CPU, memory, and time limits
Reference¶
Complete reference documentation.
- CLI Reference — every command and flag
- Configuration — TOML config format and all options
- API Reference — REST API and WebSocket endpoints
Architecture¶
How Clincus works under the hood.
- Overview — container lifecycle, PTY bridging, package structure
- Contributing — dev setup, tests, and PR process
Attribution¶
Clincus is derived from code-on-incus by Maciej Mensfeld. The web dashboard was inspired by wingthing by ehrlich-b.
Licensed under the MIT License.