| title |
role |
parent |
order |
description |
| Documentation |
part |
null |
1 |
Project documentation index |
Agent Orchestrator Documentation
Agent Orchestrator (formerly Agents Orchestrator) is a multi-project AI agent orchestration dashboard built with Tauri 2.x, Svelte 5, and the Claude Agent SDK. It transforms a traditional terminal emulator into a mission control for running, monitoring, and coordinating multiple AI agent sessions across multiple codebases simultaneously.
The application has three major version milestones:
- v1 — A single-file Python GTK3+VTE terminal emulator with Claude Code session management. Production-stable, still shipped as
agor.
- v2 — A ground-up rewrite using Tauri 2.x (Rust backend) + Svelte 5 (frontend). Multi-pane terminal with structured agent sessions, subagent tree visualization, session persistence, multi-machine relay support, 17 themes, and comprehensive packaging.
- v3 (Mission Control) — A further redesign on top of v2's codebase. Replaces the free-form pane grid with a project-group dashboard. Adds multi-agent orchestration (4 management roles), inter-agent messaging (btmsg), task boards (bttask), session anchors, health monitoring, FTS5 search, plugin system, Landlock sandboxing, secrets management, and 704 automated tests.
Important: The docs/ directory is the single source of truth for this project. Before making changes, consult the docs. After making changes, update the docs.
Documentation Map
Architecture & Design
| Document |
What It Covers |
| architecture.md |
End-to-end system architecture: Rust backend, Svelte frontend, sidecar layer, data model, layout system, data flow, IPC patterns |
| decisions.md |
Architecture decisions log: rationale and dates for all major design choices |
| multi-machine.md |
Multi-machine relay architecture: agor-core extraction, agor-relay binary, RemoteManager, WebSocket protocol, reconnection |
Subsystem Guides
| Document |
What It Covers |
| sidecar.md |
Sidecar process lifecycle, multi-provider runners (Claude/Codex/Ollama), env var stripping, CLI detection, NDJSON protocol |
| orchestration.md |
Multi-agent orchestration: btmsg messaging, bttask kanban, Tier 1/2 agent roles, wake scheduler, system prompts |
| production.md |
Production hardening: sidecar supervisor, Landlock sandbox, FTS5 search, plugin system, secrets management, notifications, health monitoring, audit logging |
| provider-adapter/ |
Multi-provider adapter pattern: architecture decisions, coupling analysis, implementation progress |
Implementation & Progress
| Document |
What It Covers |
| phases.md |
v2 implementation phases (1-7 + multi-machine A-D + profiles/skills) with checklists |
| progress/v3.md |
v3 session-by-session progress log (Phases 1-10 + production hardening) |
| progress/v2.md |
v2 session-by-session progress log (recent sessions) |
| progress/v2-archive.md |
Archived v2 progress (2026-03-05 to 2026-03-06 early) |
Research & Analysis
| Document |
What It Covers |
| findings.md |
All research: Claude Agent SDK, Tauri+xterm.js, terminal performance, adversarial review, provider coupling, codebase reuse, session anchors, multi-agent design, theme evolution, performance measurements |
Release & Testing
| Document |
What It Covers |
| release-notes.md |
v3.0 release notes: feature summary, breaking changes, test coverage, known limitations |
| e2e-testing.md |
E2E testing facility: WebDriverIO fixtures, test mode, LLM judge, CI integration, troubleshooting |
Quick Orientation
If you are new to this codebase, read the documents in this order:
- architecture.md — Understand how the pieces fit together
- decisions.md — Understand why things are built the way they are
- sidecar.md — Understand how agent sessions actually run
- orchestration.md — Understand multi-agent coordination
- e2e-testing.md — Understand how to test changes
For research context, read findings.md. For implementation history, see phases.md and progress/.
Key Directories
| Path |
Purpose |
src-tauri/src/ |
Rust backend: commands, SQLite, btmsg, bttask, search, secrets, plugins |
agor-core/ |
Shared Rust crate: PtyManager, SidecarManager, EventSink trait, Landlock sandbox |
agor-relay/ |
Standalone relay binary for remote machine support |
src/lib/ |
Svelte 5 frontend: components, stores, adapters, utils, providers |
sidecar/ |
Agent sidecar runners (Claude, Codex, Ollama) — compiled to ESM bundles |
tests/e2e/ |
WebDriverIO E2E tests, fixtures, LLM judge |
ctx/ |
Context manager CLI tool (SQLite-based, standalone) |
consult/ |
Multi-model tribunal CLI (OpenRouter, standalone Python) |
