Captain Claw

Command a fleet of AI agents

Most AI tools give you one agent in a chat box. Captain Claw Flight Deck is a multi-agent command center — spawn specialist teams, run five orchestration modes, and compose deterministic Flows. Self-hosted, MIT licensed, and works with every major LLM provider (or 100% local with Ollama).

🌐 Website · 🚀 Live Demo · 📖 Docs · 📦 PyPI

An open-source AI agent platform that thinks, remembers, and acts. It connects to OpenAI, Anthropic, Google Gemini, DeepSeek, Ollama, and OpenRouter (plus "Sign in with ChatGPT" — no API key), and gives you a rich workspace for research, document and video understanding, browser automation, and multi-agent orchestration — backed by persistent cross-session memory and autonomous "dream cycle" cognition.

Pick the right shape for the problem

One agent isn't always the answer — and one orchestration strategy never is. Captain Claw ships five distinct modes, each tuned to a different kind of work.

🛠️ Agent Forge — describe a goal, an LLM designs the whole team (roles, models, tools, SOPs)	🏛️ Agent Council — specialists deliberate across moderated rounds, then vote and synthesize
🔀 Basna — N agents answer the same question blind, merged by reliability into one high-confidence result	🤝 Vatra — a team collaborates on a shared blackboard, each owning sections, improving over review rounds

The fifth mode is Flight Deck itself (above) — spawn, monitor, and coordinate the whole crew from one dashboard.

More than orchestration

⚙️ Flows — a deterministic automation DSL (triggers, gosub, parallel spawn/join, on error), validated by a parser, not interpreted by an LLM	🔭 Observatory — it keeps thinking when you're away: a live, auditable stream of thoughts, dreams, and standing intentions

• Plan Mode & Deep Mode — for when "probably right" isn't good enough: a reviewable DAG of verified steps, and frontier-quality answers via multiple rollouts + self-consistency voting + diverse-lens critics.
• 6-layer shared memory — working, semantic (vector + BM25), deep (full-text), insights, autonomous nervous system, and self-reflection — carried across sessions and across every agent.
• Shared Virtual File System — a host-sandboxed, per-user workspace the whole fleet reads and writes, with per-file authorship.
• 24 ready-made specialists — an editable archetype library spanning research, writing, engineering, data, ops, finance, and multimedia.

See it in action

⭐ Star the repo

Captain Claw is MIT licensed and free forever — your data stays on your machine, bring your own keys or run 100% local with Ollama. It's built solo and growing fast, and every star helps another builder discover it. If it looks useful, would you give it a star?

What's New in 0.6.5

Teams that wait for each other — Vatra rendezvous, specialist tiers, and a tidier deck. Fully additive; backward compatible with 0.6.4.

• Vatra wait rendezvous. A specialist that genuinely depends on a teammate's artifact now blocks until it's ready instead of improvising a guess. A new wait action takes a path (vfs:<project>/<file>) or a query (board keywords); the /agent/wait endpoint long-polls the VFS file or blackboard every second, capped at 90s (below the dispatch timeout, so it can't hang a run). On timeout it returns a board digest + a "proceed deliberately" nudge rather than an error. Sibling owners keep working while one awaits. Waits are visible in the timeline — start (⏳ ≤Ns), resolve (✓ got file/board match), and timeout (⌛ not ready). Steered, not forced: no depends_on ordering, the tool is the whole mechanism.
• Coding & Vision tiers in the Library. Two new model tiers route work to a model suited for it — coding (default opus-4-8, 65 536 output ctx) for multi-file diffs/debugging, vision (default sonnet-4-6) for image/screenshot/document understanding. Wired through every touchpoint (archetypes, _VALID_TIERS, Dubina TIER_ORDER, consciousness _TIER_RANK, frontend). A backfillTierMap gives existing saved tier sets the new cards (inheriting provider/key). Code archetypes (code-implementer, debugger, simplifier) move to coding, and a new Vision & Multimodal family (visual-extractor, ui-reviewer, brand-design-reviewer) is added.
• Sticky phase pill + Plan-mode tokens. Basna/Vatra/Plan runs now emit an explicit phase event at every transition and show the current stage stickily in the Progress header (spinner while running) — Vatra (Planning → … → Synthesizing → … → Done), Basna (Routing → … → Done), Plan (Step x/y: <goal>). Plan mode's live agent cards now also show per-agent token counts (usage events are forwarded into the parent plan log).
• Agent Folders page. A new admin-gated Flight Deck page to inspect and clean up agent subfolders under fd-data — on-disk size, file counts, last-modified, and desktop presence (running / on-desktop / orphaned). New /fd/agentfs router (list / view / download / delete, path-sandboxed, refuses to delete a running agent) plus a file viewer that renders HTML (sandboxed iframe) and Markdown with GFM tables.

No schema changes, no new required config. New endpoints: POST /fd/<run>/agent/wait and the /fd/agentfs/* router. Existing tier configs are auto-backfilled with the new cards. See RELEASE_NOTES_0.6.5.md. Backward compatible with 0.6.4.

What's New in 0.6.4

Think way ahead, way long — Frontier Horizon comes to Basna & Vatra. Fully additive; everything new is off by default.

• Deep mode. A new toggle on the Basna/Vatra page spends test-time compute, gated by verifiers, to reach frontier-grade quality on cheaper models. In Basna each worker spawns a pool of independent rollouts, self-consistency-votes, runs the leading answer past a panel of diverse-lens critics (the phrygian/aeolian/locrian cognitive modes as adversarial refuters), and fixes with the critique. In Vatra each owner's slice is verified and revised (blackboard-safe — no spawn pools). And a closer reviews the final merged answer / assembled deliverable and rewrites it once if a majority of critics refute it. Critics always run on a model different from the producer (never self-grading), and the whole thing is budget-bounded.
• Plan mode — the long-horizon lever. A new toggle decomposes a task into ordered steps, drives each to a verified result before the next, re-plans the remainder when a step can't be verified, and synthesizes from the verified steps — so the system never compounds an unverified step. Each step can run as a single fast model, a full Basna ensemble, or a full Vatra team (chosen by the mode card); the step's live agent activity is mirrored into the plan log. Tick parallel and the planner emits a dependency graph so independent steps run in concurrent waves. New endpoint POST /fd/basna/plan.
• VFS provenance. The shared cross-agent filesystem viewer now shows timestamps on every file/folder, the agent that wrote each file (an append-only, concurrency-safe sidecar), and the Basna/Vatra run title behind each basna-… / vatra-… project.
• Redesigned controls. The scattered row of selects and checkboxes is replaced by a single Effort choice — Standard · Deep · Plan — with progressive disclosure (only the chosen effort's options show), router tier and