Orcan

Orcan

**Work-context orchestrator** for coding agents. Run **Cursor CLI** (`agent`), **Claude Code** (`claude`), and **Codex CLI** (`codex`) in Docker with path-parity mounts, workspaces (named sets of projects), and an optional browser tmux terminal.

Models are out of scope — each CLI picks its own.

[Documentation (EN)](https://akyther.github.io/orcan/latest/) · [Dokumentacja (PL)](https://akyther.github.io/orcan/latest/pl/) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md)

Status

Version **3.0.5**. Distributed as a **CLI** (`orcan`). `orcan build` pulls the image for this version when available, otherwise builds locally. Publishing images is **manual** (`orcan publish`) and not part of build. CI validates and publishes docs; it does **not** publish container images.

Features

• Workspaces (one tmux session per workspace)
• Path parity (same absolute paths host ↔ container)
• Images: orcan:latest / orcan: (all agents); optional local orcan:-claude / -cursor / -codex
• Local container by default (orcan enter on the same machine)
• Optional browser terminal (orcan up --with-ttyd → ttyd → launcher → tmux → zsh)
• Host data under ~/.config/orcan (ORCAN_DATA)
• JSON config + wizard (orcan.config.json)
• Docs in English and Polish (language switcher on the site)

Requirements

Tool	Role
Bash	orcan CLI dispatcher
Python 3	Host config: sync, init (incl. wizard), context (show / add / hook) — stdlib only, no pip
Git	Install clone + your projects
Docker (Compose v2)	Container runtime (orcan up, optional --with-ttyd)

`orcan` itself is Bash; several commands call small Python helpers on the host. `orcan doctor` checks all of the above.

Install

curl -fsSL https://raw.githubusercontent.com/aKyther/orcan/main/install.sh | bash

Adds `orcan` to `~/.local/bin` and appends that directory to your shell rc (`~/.zshrc` / `~/.bashrc`) if ne