https://github.com/bketelsen/clincus
(more) Secure container runtime for AI coding tools on Incus
https://github.com/bketelsen/clincus
claude copilot incus remote shell terminal web
Last synced: 3 months ago
JSON representation
(more) Secure container runtime for AI coding tools on Incus
- Host: GitHub
- URL: https://github.com/bketelsen/clincus
- Owner: bketelsen
- License: mit
- Created: 2026-03-16T19:32:30.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-26T04:04:16.000Z (3 months ago)
- Last Synced: 2026-03-26T12:57:02.639Z (3 months ago)
- Topics: claude, copilot, incus, remote, shell, terminal, web
- Language: Python
- Homepage: https://bketelsen.github.io/clincus/
- Size: 1.2 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Clincus
Secure and fast container runtime for AI coding tools on Linux.
Run [Claude Code](https://docs.anthropic.com/en/docs/claude-code),
[GitHub Copilot CLI](https://gh.io/copilot),
[opencode](https://github.com/nicholasgasior/opencode),
[Aider](https://aider.chat), and other AI assistants
in isolated [Incus](https://linuxcontainers.org/incus/) containers
with session persistence, a web dashboard, and resource limits.
## Features
- **Container isolation** — each session runs in its own Incus container
- **Session persistence** — save and resume AI conversations with full history
- **Web dashboard** — launch and manage sessions from your browser
- **Multi-tool support** — Claude Code, GitHub Copilot CLI, opencode, Aider, and custom tools
- **Workspace mounting** — project files mounted in isolated containers
- **Snapshots** — checkpoint and rollback container state
- **Resource limits** — CPU, memory, and time limits per session
- **File transfer** — push/pull files between host and containers
## Quick Start
### Install
Download the latest release from [GitHub Releases](https://github.com/bketelsen/clincus/releases)
or build from source:
```bash
git clone https://github.com/bketelsen/clincus.git
cd clincus
make install
```
### First Session
```bash
# Build the container image (one-time setup)
clincus build
# Start a Claude Code session
clincus shell --tool claude ~/my-project
```
## Documentation
Full documentation is available at [bketelsen.github.io/clincus](https://bketelsen.github.io/clincus).
## Attribution
Clincus is derived from [code-on-incus](https://github.com/mensfeld/code-on-incus)
by [Maciej Mensfeld](https://github.com/mensfeld). The web dashboard was inspired by
[wingthing](https://github.com/ehrlich-b/wingthing) by [ehrlich-b](https://github.com/ehrlich-b).
## License
MIT — see [LICENSE](LICENSE) for details.