Flywheel Gateway

Flywheel Gateway

**SDK-first multi-agent orchestration platform** for managing AI coding agents at scale.

[](LICENSE)

Overview

Flywheel Gateway provides infrastructure for orchestrating multiple AI coding agents (Claude, Codex, Gemini) with:

• BYOA (Bring Your Own Account) - Use your own API keys with automatic rotation and failover
• Real-time Dashboard - Monitor agent sessions, outputs, and health via WebSocket
• DCG (Destructive Command Guard) - Prevent dangerous operations before they execute
• Fleet Management - Coordinate agents across multiple repositories
• Cross-Agent Search - Learn from past agent sessions via CASS indexing

Quick Start

Prerequisites

• Bun 1.3+
• Node.js 20+ (for some tooling)

Installation

# Clone the repository
git clone https://github.com/Dicklesworthstone/flywheel_gateway.git
cd flywheel_gateway

# Install dependencies
bun install

# Initialize the database
bun db:migrate

# Start development servers
bun dev

The gateway API will be available at `http://localhost:3000` and the web dashboard at `http://localhost:5173`.

Environment Variables

Create a `.env` file in the root directory:

# Database (SQLite for development)
DATABASE_URL="file:./data/gateway.db"

# Authentication
JWT_SECRET="your-secret-key-at-least-32-chars"

# Optional: External services
ANTHROPIC_API_KEY=""
OPENAI_API_KEY=""
GOOGLE_AI_API_KEY=""

Architecture

flywheel_gateway/
├── apps/
│   ├── gateway/          # Hono API server + WebSocket
│   └── web/              # React dashboard
├── packages/
│   ├── shared/           # Shared types and utilities
│   ├── flywheel-clients/ # SDK clients (CASS, CM)
│   └── test-utils/       # Testing utilities
├── tests/
│   ├── e2e/              # Playwright E2E tests
│   ├── contract/         # API schema validation
│   └── load/