Architecture

Maestro is a local TypeScript runtime with a SQLite persistence layer, an HTTP Dashboard API, a Vite UI in development, provider adapters and coordinators for Goals, review, autopilot and optional Telegram.

Runtime path

Dashboard / CLI / Telegram / Chat
              ↓
      application commands + API
              ↓
       SQLite + coordinators
              ↓
    Goal → AgentRegistry → provider CLI/API
              ↓
      Git worktree + validation + PR

The AgentRegistry owns health, leases and cooldowns. GoalCoordinator schedules persistent runs. GoalDeliveryHandler creates the commit/PR evidence. ReviewCoordinator manages the human queue and reconciles GitHub state.

Development and desktop

Development runs the backend/API and Vite UI separately. The Windows app packages compiled backend and UI inside Electron, uses a per-user data directory, and launches the same orchestrator contract. The terminal launcher is backed by the bundled runtime in the installed app.

Design principle

The Dashboard is a view over application contracts, not a second implementation of task execution. CLI and Telegram should call the same commands so a task created in one surface is visible and controllable in the others.