Nexus Flow ⚡
A framework-agnostic Command Center designed to bridge the gap between static Spec-Driven Development (SDD) and the chaotic, high-speed execution of Multi-Agent Systems.
Overview
While tools like AgentFlow focus on the execution log, Nexus Flow focuses on the Execution-to-Spec Alignment. It treats your Markdown (.md) specification files as the living brain of the project and the UI as the interactive nervous system.
This project provides a "Single Pane of Glass" where a Software Architect can watch a swarm of AI agents execute a complex technical specification in real-time, with the power to approve, redirect, or pause the flow directly from a dynamic node graph.
Features
- Real-Time Orchestration Canvas: Interactive visualization of your
.md specifications using React Flow.
- Agent Tethering Engine: Watch your AI agents (Claude, Codex, etc.) move through the spec graph as "Ghost Nodes", trailing active task execution lines.
- Blast Radius Calculation: Intelligent detection of stale nodes when an upstream dependency is modified.
- Approval Gates: Right-click to gate, approve, or reject changes, with bi-directional syncing to Markdown frontmatter.
- Standalone Web SPA: Run locally with zero backend required, utilizing the File System Access API.
- VS Code Extension: Native integration into your IDE for direct code editing and real-time canvas updates.
Monorepo Structure
@nexus-flow/core: Pure TypeScript parser engine and Zustand state container.@nexus-flow/ui: React Flow custom nodes, edges, and visual components.@nexus-flow/web: Vite-based Standalone SPA using File System Access API.@nexus-flow/vscode: VS Code Extension wrapping the Web SPA in a Webview.
Getting Started
Prerequisites
- Node.js >= 18.18 (20+ recommended)
pnpm >= 9.x
Installation
```bash
pnpm install
```
Running the Web SPA
```bash
pnpm --filter @nexus-flow/web dev
```
Then navigate to http://localhost:5174 and click "Open Folder" to load your SDD project (or your openspec change folder).
Running the VS Code Extension
- Open this repository in VS Code.
- Press
F5 to launch the Extension Development Host.
- In the new window, run the command:
Nexus Flow: Open Command Center.
Agent Configuration
Nexus Flow automatically monitors known agent log directories. You can extend this by adding a nexus-flow.config.json file to the root of your project:
```json
{
"agents": [
{
"name": "custom-agent",
"logDir": "./.agent-logs",
"pattern": "*.jsonl"
}
]
}
```
License
MIT License
