# Documentation

- [Introduction](/docs): Arbiter local development control plane documentation

- **Concepts**
- [System Architecture & Safety Boundaries](/docs/architecture): Explore Arbiter's domain-driven architecture, single-process execution model, Linux /proc and ss correlation layer, and immutable safety boundaries.
- [Safety, Approvals & Verification](/docs/safety-and-verification): The 5 risk tiers, immutable approvals, time-travel diffs, and post-action verification.
- [Topology & Resource Graph](/docs/topology): Live workstation resource graph, Linux kernel correlations, and natural-language filtering.

- **Features**
- [Multi-Project Stacks & Environment Switcher](/docs/stacks): Multi-project environment profiles, 1-click context switching, topological DAG boot ordering (Kahn's algorithm), and live dependency readiness gates.
- [Config & Secrets Intelligence](/docs/config-secrets-intelligence): Port drift detection, safe environment variable auditing, and visual diff dry-run time-travel previews.
- [Docker & Compose Orchestration](/docs/docker-and-compose): Container lifecycle, Compose port editing, logs, metrics, volumes, and disk usage safety.
- [Config Editor, Make & Dockerfile Intelligence](/docs/files-and-make): Safe configuration editing, SHA-256 validation, backup/undo pipeline, Makefile target runner, and Dockerfile diagnostics.

- **Interfaces**
- [Web Control Panel & Observability](/docs/ui): Comprehensive browser control panel walkthrough with live topology canvas, container logs/metrics, localhost previews, and safety approvals.
- [CLI Commands & Terminal Ergonomics](/docs/cli): Developer-first command-line interface with interactive fzf-style fuzzy selectors, structured JSON outputs, and Starship prompt integration.
- [Terminal UI (TUI) Mode](/docs/tui): Fast, keyboard-driven terminal dashboard for navigating ports, containers, approvals, and logs.

- **Protocols & Integrations**
- [Model Context Protocol (MCP)](/docs/mcp): Connect Arbiter as an MCP server to Claude Desktop, Cursor, Zed, Antigravity, and other AI clients.
- [Agent-to-Agent (A2A) Protocol](/docs/a2a): Agent Card specification and inter-agent task execution protocol.
- [AI Agent & Tool Runtime](/docs/agent-runtime): LangChain/LangGraph agent architecture, typed tool registry, model providers, and NDJSON streaming.

- **Reference**
- [Configuration Reference](/docs/configuration): Environment variables, settings, safety flags, and discovery parameters.
- [REST API & Streaming Reference](/docs/api): Exhaustive endpoint documentation for Arbiter REST API, SSE events, and NDJSON streaming.
- [Development & Contributing Guide](/docs/development): Development workflow, testing with pytest and hypothesis, building the UI, and docs guide.