631fc2efc8
- schema/canonical.sql: 29 tables across 3 databases, CHECK constraints, foreign keys, 13 indexes, WAL mode, schema_version tracking - tools/validate-schema.ts: applies DDL to in-memory SQLite, extracts PRAGMA table_info + sqlite_master metadata as JSON - tools/migrate-db.ts: CLI for Tauri→Electrobun data migration with atomic transaction, version fencing, INSERT OR IGNORE - docs/SWITCHING.md: migration guide with prerequisites and troubleshooting |
||
|---|---|---|
| .. | ||
| agents | ||
| architecture | ||
| config | ||
| contributing | ||
| getting-started | ||
| multi-machine | ||
| plugins | ||
| pro | ||
| production | ||
| progress | ||
| provider-adapter | ||
| providers | ||
| sidecar | ||
| README.md | ||
| release-notes.md | ||
| SWITCHING.md | ||
Agents Orchestrator — Documentation
Multi-project AI agent dashboard with terminal, SSH, and multi-provider session management. Built with Tauri 2.x (Rust) + Svelte 5 + Claude Agent SDK.
Source of truth. Before making changes, consult these docs. After making changes, update them.
Quick Navigation
| Audience | Start Here |
|---|---|
| New users | Getting Started |
| Contributors | Dual-Repo Workflow, Testing |
| Pro customers | Pro Edition, Marketplace |
| Plugin developers | Plugin Development Guide |
Documentation Map
Getting Started
- Quickstart — install, build, first agent session
Architecture
- System Overview — components, data flow, IPC patterns
- Data Model — SQLite schemas, layout, keyboard shortcuts
- Decisions — architecture decision log with rationale
- Phases — v2 implementation phases (P1-7 + multi-machine A-D)
- Research Findings — SDK, performance, coupling analysis
Agents & Orchestration
- Orchestration — btmsg, bttask, 4 management roles, wake scheduler, session anchors
- btmsg Reference — inter-agent messaging CLI and database schema
- bttask Reference — kanban task board CLI and operations
Providers
- Provider Reference — Claude, Codex, Ollama, Aider: models, capabilities, routing
Sidecar
- Sidecar Architecture — runners, NDJSON protocol, crash recovery, env stripping
Multi-Machine
- Relay Architecture — WebSocket server, TLS, SPKI pinning, reconnection
Production Hardening
- Hardening — sidecar supervisor, Landlock sandbox, WAL checkpoint, TLS relay
- Features — FTS5 search, plugin sandbox, secrets, notifications, audit, error classification
Configuration
- Settings Reference — env vars, config files, databases, themes, per-project settings
Plugins
- Plugin Development Guide — Web Worker sandbox API, manifest, publishing, examples
Contributing
- Dual-Repo Workflow — community vs commercial repos, sync, leak prevention
- Testing — E2E fixtures, test mode, LLM judge, CI integration
Pro Edition (Commercial)
- Pro Overview — feature list, plugin architecture, IPC pattern
- Analytics Dashboard — cost/token/model tracking over time
- Cost Intelligence — budget governor, smart model router
- Knowledge Base — persistent memory, codebase symbol graph
- Git Integration — context injection, branch policy
- Marketplace — 13 plugins (8 free + 5 paid), catalog, install/update
Release History
- Release Notes — v3.0 features, breaking changes, requirements
Progress Logs
- v3 Progress — session-by-session development log
- v2 Progress
- v2 Archive
Key Directories
| Path | Purpose |
|---|---|
src-tauri/src/ |
Rust backend: commands, SQLite, btmsg, bttask, search, secrets, plugins |
agor-core/ |
Shared Rust crate: PtyManager, SidecarManager, EventSink, Landlock sandbox |
agor-relay/ |
Standalone relay binary for remote machine support |
agor-pro/ |
Commercial plugin crate (Pro edition features) |
src/lib/ |
Svelte 5 frontend: components, stores, adapters, utils, providers |
src/lib/commercial/ |
Pro edition Svelte components and IPC bridge |
sidecar/ |
Agent sidecar runners (Claude, Codex, Ollama, Aider) — ESM bundles |
tests/e2e/ |
WebDriverIO E2E tests, fixtures, LLM judge |
tests/commercial/ |
Pro edition tests (excluded from community builds) |
scripts/ |
Build scripts, plugin scaffolding, test runner |
.githooks/ |
Pre-push leak prevention hook |
Reading Order for New Contributors
- Getting Started — build and run
- System Overview — how the pieces fit
- Decisions — why things are built this way
- Sidecar Architecture — how agent sessions run
- Orchestration — multi-agent coordination
- Testing — how to test changes
- Dual-Repo Workflow — how to contribute