Agent Orchestrator runs as a long-running Go backend daemon
(backend/) plus an Electron + TypeScript frontend (frontend/). The backend
supervises coding-agent sessions and exposes daemon control, project/session
state, terminal streaming, and CDC/event infrastructure.
Start with architecture.md for the current backend model and cli/README.md for the CLI surface.
Gemini CLI setup, permission mapping, and current capability limits are documented in gemini-cli.md.
| Doc | What it covers |
|---|---|
| documentation-map.md | Human-facing docs vs the machine-readable contract layer, source of truth per concern, and the CI gates that hold it. |
| documentation-coverage.md | Stable-release baseline, covered user paths, and hands-on verification still needed. |
| Public manual sources | Existing user guides, configuration, capability catalog, CLI reference, and mobile access pages. |
| architecture.md | Current backend model, package layout, status derivation, persistence/CDC, and load-bearing rules. |
| scm-observer.md | SCM subsystem: polling pipeline, durable-state invariants, PR identity model, and the rename/transfer design. |
| backend-code-structure.md | Package ownership rules for the Go backend: domain, services, ports, adapters, storage, HTTP, CLI, and daemon wiring. |
| cli/README.md | CLI commands and daemon control surface. |
| cloud-development.md | Current public Cloud sources, local stack, tests, and hosted-environment boundaries. |
| cloud-refactor.md | Historical split design for shared Cloud contracts and UI; not the current setup guide. |
| self-hosted-remote.md | Experimental multi-host setup, client workflow, security boundary, and current limits. |
| development.md | Prerequisites, build steps, running tests, and troubleshooting for local development. |
| harnesses/unreal-agent.md | Built-in Unreal Agent Chat setup, provider environment, persistence, and current limits. |
| harnesses/mimo-code.md | MiMo Code TUI setup, permissions, activity hooks, exact restore, and current limits. |
| harnesses/deepseek-harness.md | DeepSeek Harness Chat over ACP, headless task mode, credentials, and current limits. |
| harnesses/command-code.md | Command Code TUI setup, activity hooks, Chat over cmd acp, exact restore, and current limits. |
| STATUS.md | What is shipped on main today and what is still in flight. |
| stack.md | Accepted library/runtime choices, pending stack decisions, and dependencies explicitly avoided for V1. |
| telemetry.md | User-facing overview of product telemetry, privacy safeguards, and opt-out controls. |
| posthog-cost-controls.md | PostHog event-name migration, ingestion drop rules, and dashboard queries for reducing telemetry spend. |
See startup-cues.md for command cues that gate a new worktree’s opening turn.
Persist durable facts, derive display status:
- session table:
activity_state,is_terminated, identity, metadata - PR tables: PR/CI/review facts
- derived read model:
service.Sessioncomputes display status from session + PR facts