Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Project Status

Caliban v0.1.0 is a pre-release. The binary (caliban) is daily-usable from main; the core agent loop, TUI, headless mode, sessions, permissions, tools, MCP, sub-agents, memory, sandbox, and telemetry are all shipped. A number of parity gaps with Claude Code remain.

What is shipped

The table below summarizes the major shipped areas. All items marked ✅ are available on main today.

AreaStatus
Interactive TUI (ratatui, transcript, status bar, slash menu, @file picker)
Headless --print / stream-json I/O protocol
Persistent named sessions (--session, --resume, --continue)
Permissions: rule grammar, six modes, caliban perms CLI, audit log
Built-in tools (Read, Write, Edit, MultiEdit, Glob, Grep, Bash, BashBg, WebFetch, WebSearch, NotebookEdit, TodoWrite, AgentTool, Memory, Plan)
MCP client (stdio + HTTP, OAuth, elicitation, per-server permissions)
Sub-agents (in-process, background fleet via caliband, worktree isolation)
Memory tiers: CLAUDE.md ancestry, @-imports, auto-memory
Settings layering (Managed > User > Project > Local, deep-merge, live reload)
Model router v2 (declarative routes, fallback chains, circuit breakers, capability filters)
Providers: Anthropic, OpenAI, Google Gemini, Ollama, Bedrock, Vertex
Checkpoints + /rewind
Plugins, hooks, skills
OS sandbox (Seatbelt on macOS, bubblewrap on Linux)
OpenTelemetry + per-request cost tracking

What is partial or backlog

Some rows in the parity matrix are 🟡 (partial / experimental):

AreaState
Slash-menu typeahead🟡 partial
Multi-line input (Shift+Enter native)🟡 partial
Vim editing mode in TUI🔴 not yet
Cost surfacing in TUI (/cost display)🟡 backlog
GitHub Actions workflow / devcontainer feature🔴 planned
IDE extensions, GitHub App, remote control, mobile (theme N)🔴 parked until CLI parity

Theme N surfaces are parked

IDE extensions, the GitHub App, claude.ai/code, iOS, Slack integration, Remote Control, Channels, Routines, Deep links, and Teleport are all tracked in the parity matrix under theme N. They are explicitly parked until the terminal/CLI feature set reaches full parity with Claude Code. Do not rely on any of these surfaces being available in the near term.

For the full up-to-date breakdown, see Parity vs Claude Code. If you hit something unexpected, see Troubleshooting.

License

Caliban is licensed under AGPL-3.0-only. See Philosophy for the rationale.