How milkslayer/synapse works
Synapse is a real-time messaging and team-coordination system for Claude Code agent fleets and human operators. A typical workflow starts when an agent uses MCP tools to register, claim a role, join a team, or send a message. The server maintains identities and team membership, routes messages, and records per-instance events; the channel plugin polls those events and pushes them into Claude Code to trigger agent turns. The README documents the operator UI and broader team workflow. Source excerpts are partial, so internal server relationships are shown only where supported.
Main entry points: synapse_v2.py HTTP API · server_v2.py Registration and identity sync · server.js Channel MCP plugin · session_map_hook.py Session mapping hook
Components 14
Messaging server
- HTTP API
server/synapse_v2.py - Identity and presence
server/synapse_v2.py - Teams, roles, invites
server/synapse_v2.py - Message routing
server/synapse_v2.py - Instance event stream
server/synapse_v2.py - SQLite state
server/synapse_v2.py
MCP bridge
- Synapse MCP tools
mcp-bridge/server_v2.py - Registration and identity sync
mcp-bridge/server_v2.py - Session mapping hook
mcp-bridge/session_map_hook.py
Channel delivery
- Channel MCP plugin
channel-plugin/server.js
Operator interface
- Operator web UI
server/ui_v2.html
Other components
- Human operator
- Claude Code session
- Session lease files
Connections 19
- Human operator → Operator web UI: operates
README.md - Operator web UI → HTTP API: uses server
README.md - Claude Code session → Synapse MCP tools: invokes tools
README.md - Synapse MCP tools → HTTP API: calls endpoints
mcp-bridge/server_v2.py - Registration and identity sync → HTTP API: registers identity
mcp-bridge/server_v2.py - HTTP API → Identity and presence: handles identity routes
server/synapse_v2.py - HTTP API → Teams, roles, invites: handles team routes
server/synapse_v2.py - HTTP API → Message routing: handles send requests
server/synapse_v2.py - Message routing → Instance event stream: records recipient events
README.md - Identity and presence → SQLite state: reads and writes
server/synapse_v2.py - Teams, roles, invites → SQLite state: reads and writes
server/synapse_v2.py - Message routing → SQLite state: reads and writes
server/synapse_v2.py - Instance event stream → SQLite state: reads and writes
server/synapse_v2.py - Channel MCP plugin → Instance event stream: polls events
channel-plugin/server.js - Channel MCP plugin → Claude Code session: pushes channel events
channel-plugin/server.js - Registration and identity sync → Session lease files: writes lease
mcp-bridge/server_v2.py - Channel MCP plugin → Session lease files: reads lease
channel-plugin/server.js - Session mapping hook → Session lease files: writes session maps
mcp-bridge/session_map_hook.py - Registration and identity sync → Session mapping hook: reads session mapping
mcp-bridge/server_v2.py