- ADR 0000 · Record architecture decisions
- ADR 0001 · Async runtime →
tokio
- ADR 0002 · Error model →
thiserror for libraries, anyhow for binary
- ADR 0003 · License →
AGPL-3.0-only
- ADR 0004 · Naming →
caliban-* libraries, caliban binary
- ADR 0005 · Workspace layout →
crates/ for libraries, binaries at root
- ADR 0006 · Message schema → provider-neutral IR
- ADR 0007 · Schema/transport factoring via Transport trait
- ADR 0008 · Role::System messages are positional (leading-only)
- ADR 0009 · Agent-core design (stream-as-primitive, sequential tools, opt-in compaction)
- ADR 0010 · WorkspaceRoot path resolution + opt-in restricted mode
- ADR 0011 · Sessions persisted to disk + interactive REPL
- ADR 0012 · TUI via ratatui (replacing the rustyline REPL)
- ADR 0013 · TUI overlays + layout v2 (input bracketed by horizontal rules)
- ADR 0014 · Default system prompt + TUI stall fixes + debug logging
- ADR 0015 · Context preservation + path conventions (~/dev fix)
- ADR 0016 · Parallel tool dispatch (supersedes ADR 0009 §"sequential tools")
- ADR 0017 · MCP client architecture
- ADR 0018 · Memory tier model (CLAUDE.md ingestion + auto-memory)
- ADR 0019 · Skills loading
- ADR 0020 · Permission rules layered on top of
Hooks
- ADR 0021 · Sub-agent primitive via
AgentTool
- ADR 0022 · Model routing architecture
- ADR 0023 · MCP v2 — transports, OAuth, elicitation, resources
- ADR 0024 · Hook event taxonomy + external handler types
- ADR 0025 · Headless
-p mode + JSON output protocol
- ADR 0026 · Layered settings.json +
/config editor
- ADR 0027 · TUI ergonomics pack
- ADR 0028 · Checkpointing +
/rewind
- ADR 0029 · Permission modes + auto-mode classifier
- ADR 0030 · Plugin packaging
- ADR 0031 · Output styles
- ADR 0032 · OS-level sandbox
- ADR 0033 · OpenTelemetry export + cost tracking
- ADR 0034 · Bedrock + Vertex providers
- ADR 0035 · Auto-memory (model-written notes)
- ADR 0036 · CLAUDE.md ancestor walk +
@-imports
- ADR 0037 · Sub-agent worktree isolation + background fleet
- ADR 0038 · Model router v2 — fallback, hedging, breakers, capabilities, binary wiring
- ADR 0039 · Image + vision input
- ADR 0040 · Slash command registry
- ADR 0041 · TUI redraw tick close-out
- ADR 0042 ·
caliband sibling-binary placement
- ADR 0043 ·
arc-swap as the read-mostly shared-state primitive
- ADR 0044 ·
rmcp 1.7 version pin
- ADR 0045 · Permissions v2 — TOML-primary config + richer rule schema
- ADR 0046 · Two-stage tool surface — lazy MCP schema loading + ToolSearch
- ADR 0047 · Interactive background sub-agents (idle / await-input)