How ovich/swarmstorm works
Swarmstorm coordinates coding agents through a shared board and exposes live run activity and project documents in aiview. A typical user asks an orchestrator to run a swarm; agents coordinate through the board, and the user follows the run and reviews its outputs in the browser. The graph emphasizes the board’s CLI/server/store path and aiview’s UI/API path. It also preserves documented protocol, prototype, workbench, and QA capabilities; their implementation details were not sampled, so links to them are not asserted.
Main entry points: board.ts Board state · index.ts Swarm CLI · server.ts Board server · App.tsx aiview browser UI
Components 24
Swarm coordination
- Swarm CLI
skills/companions/swarm-board/src/cli/index.ts - Orchestrator
skills/companions/swarm-board/src/cli/answer/orchestrators.ts - Agent link
skills/companions/swarm-board/src/link/link.ts
Board runtime
- Board server
skills/companions/swarm-board/src/server/server.ts - RPC authority
skills/companions/swarm-board/src/server/authority.ts - Wire protocol
skills/companions/swarm-board/src/wire.ts - Board state
skills/companions/swarm-board/src/board/board.ts - Board events
skills/companions/swarm-board/src/board/events.ts - Mention routing
skills/companions/swarm-board/src/board/mentions.ts - Code pack
skills/companions/swarm-board/src/packs/code
aiview
- aiview browser UI
skills/companions/aiview/app/App.tsx - Board viewer
skills/companions/aiview/app/components/viewers/board/BoardView.tsx - Document viewers
skills/companions/aiview/app/components/viewers - Document state hook
skills/companions/aiview/app/hooks/useDocuments.ts - Web API client
skills/companions/aiview/app/lib/api.ts
Document services
- HTTP server
skills/companions/aiview/src/server/index.ts - Document index
skills/companions/aiview/src/core/db.ts - Document paths
skills/companions/aiview/src/core/paths.ts - Live event stream
skills/companions/aiview/src/server/sse.ts
Agent capabilities
- Swarm protocols
skills/companions/swarm-board/src/cli - QA verifiers
skills - Prototypes
skills/companions/aiview/app/components/viewers/PrototypeFrame.tsx - Workbenches
skills/workbench/create-workbench
Other components
- User
Connections 25
- User → Swarm CLI: starts swarm
- Swarm CLI → Orchestrator: formats orchestration
skills/companions/swarm-board/src/cli/answer/orchestrators.ts - Swarm CLI → Board state: issues board calls
skills/companions/swarm-board/src/cli/index.ts - Swarm CLI → Agent link: connects members
skills/companions/swarm-board/src/cli/index.ts - Agent link → Board server: communicates with
- Board server → Board state: opens board
skills/companions/swarm-board/src/server/server.ts - Board server → RPC authority: checks calls
skills/companions/swarm-board/src/server/server.ts - Board server → Wire protocol: encodes frames
skills/companions/swarm-board/src/server/server.ts - RPC authority → Board state: authorizes methods
skills/companions/swarm-board/src/server/authority.ts - Board state → Mention routing: parses mentions
skills/companions/swarm-board/src/board/board.ts - Board state → Board events: records events
skills/companions/swarm-board/src/board/board.ts - Board state → Code pack: dispatches pack
- User → aiview browser UI: reviews live work
- aiview browser UI → Web API client: fetches documents
skills/companions/aiview/app/App.tsx - aiview browser UI → Board viewer: renders board
skills/companions/aiview/app/App.tsx - aiview browser UI → Document viewers: renders documents
skills/companions/aiview/app/App.tsx - Document state hook → Web API client: loads documents
skills/companions/aiview/app/hooks/useDocuments.ts - Web API client → HTTP server: requests API
- HTTP server → Document index: reads document index
skills/companions/aiview/src/server/index.ts - HTTP server → Document paths: reads document files
skills/companions/aiview/src/server/index.ts - HTTP server → Live event stream: creates event hub
skills/companions/aiview/src/server/index.ts - User → Swarm protocols: chooses workflow
- User → QA verifiers: reviews delivery
- User → Prototypes: approves screens
- User → Workbenches: uses custom tools