AI Agent Swarm Orchestrator - A desktop application for visualizing and orchestrating multiple AI coding agents in parallel.
Constellation implements Geoffrey Huntley's "Ralph" technique at scale, transforming the simple while :; do cat PROMPT.md | agent ; done pattern into a visual, multi-project orchestration platform.
- Real-time force-directed graph visualization of agent swarms
- Click-to-inspect agent internals and streaming output
- Cost tracking, budget enforcement, and circuit breakers
- State persistence and session recovery
- Multi-project parallel execution
- Runtime: Electron 30.x
- Frontend: React 18.x + TypeScript 5.x
- Visualization: React Flow 12.x
- State Management: Zustand 4.x
- Database: SQLite via better-sqlite3
- AI Integration: Anthropic Claude SDK
- Styling: Tailwind CSS 3.x
- Node.js >= 18.0.0
- npm >= 9.0.0
# Install dependencies
npm install# Run in development mode with hot reload
npm run dev
# Run tests
npm test
# Run linter
npm run lint
# Format code
npm format# Build for production
npm run build
# Package for current platform
npm run package
# Package for specific platforms
npm run package:mac
npm run package:win
npm run package:linuxconstellation/
├── src/
│ ├── main/ # Electron main process
│ ├── preload/ # IPC bridge
│ └── renderer/ # React frontend
├── resources/ # App icons and assets
├── docs/ # Documentation
└── release/ # Built packages
See CLAUDE.md for detailed architecture documentation and development guidelines.
MIT
Shaal