Status: PROTOTYPE_PHASE | Core: REACT_19 | Style: RETRO_FUTURISM
Orchestra OS is a high-fidelity dashboard console designed for managing, monitoring, and orchestrating autonomous AI agents. Built with a "retro-futuristic" blueprint aesthetic, it combines raw data visualization with module-based control cards.
Key Modules:
- SQUAD_UNITS (Dashboard): Real-time agent status grid, throughput monitoring, and rapid deployment tools.
- CORTEX-ANALYZER (Synthesis): High-fidelity neural map visualization for knowledge convergence and artifact analysis.
- LOGIC-GATE (CLI): Direct terminal access for raw log streams and system overrides.
- BLUEPRINT_DECK (Docs): System specs, API references, and architectural blueprints.
Execute this sequence to hydrate and launch the system immediately:
# Install dependencies, initialize database, and launch
pnpm setup && pnpm dev| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript, Tailwind CSS |
| Build | Vite 6 with code splitting |
| Backend | Express 5 |
| Database | SQLite via Prisma 7 |
| Charts | Recharts 3 |
Follow these directives to initialize the local environment.
Ensure your terminal is equipped with the following runtimes:
- Node.js (v18.0.0 or higher recommended)
- pnpm (recommended) or npm
Execute the following command to hydrate the node_modules sector:
pnpm installInitialize the SQLite database with Prisma:
pnpm prisma migrate devInitiate the development servers (frontend + backend):
pnpm devAccess the console via http://localhost:3000
Note
The dashboard uses HMR (Hot Module Replacement). If visual artifacts persist after a code update, perform a hard refresh (Cmd + Shift + R or Ctrl + F5).
| Command | Description |
|---|---|
pnpm dev |
Start Vite + Express concurrently |
pnpm build |
Build frontend for production |
pnpm preview |
Preview production build |
pnpm start:server |
Start Express server only |
RESTful endpoints served on port 3001 (proxied via Vite):
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/agents |
List all agents |
POST |
/api/agents |
Create new agent |
PUT |
/api/agents/:id/status |
Update agent status |
GET |
/api/logs |
Get recent logs (100 max) |
POST |
/api/logs |
Create log entry |
| Status | Description |
|---|---|
RUNNING |
Agent is actively processing |
IDLE |
Agent is waiting for tasks |
ERROR |
Agent encountered an error |
OFFLINE |
Agent is terminated |
| Level | Description |
|---|---|
INF |
Informational message |
WRN |
Warning |
ERR |
Error |
FAT |
Fatal error |
SYS |
System message |
USR |
User action |
- Deploy Agent: Use the "NEW_DEPLOYMENT" button in the sidebar to spawn new agent instances.
- Search Protocol: Use the header input
QUERY_AGENT_REGISTRY...to filter active units by name or role. - Unit Control:
- PLAY: Resume agent execution (Status: RUNNING).
- PAUSE: Halt agent execution (Status: IDLE).
- TERMINATE: Kill agent process (Status: OFFLINE).
The interface uses a strict Tailwind CSS configuration for its unique look.
- Colors: Defined in
tailwind.config.ts(e.g.,gb-bg0,li-primary). - Fonts: Uses
JetBrains Mono(Monospace) andSpace Grotesk(Display).
The build is optimized for production:
| Metric | Value |
|---|---|
| Initial Bundle | 214 KB (gzipped: 66 KB) |
| Vendor Charts | 303 KB (gzipped: 93 KB) |
| Dashboard Chunk | 28 KB |
| CLI Chunk | 9 KB |
| Docs Chunk | 3 KB |
| Build Time | ~1.4s |
Optimization Features:
- Code splitting with React.lazy()
- Vendor chunking (react, recharts)
- Component memoization (React.memo)
- Stable handlers (useCallback)
- Conditional intervals (view-aware)
- Architecture Guide - System design and optimization details
- API Documentation - Component props and endpoint reference
"Harmonizing Syntax and Silicon"
© 2026 Orchestra Operations