How fengjunchengcode/cc-relay-hub works
cc-relay-hub is a local relay for private agent-to-agent tasks and replies, with CLI discovery, cc-connect and Electron IDE routes, and a hook server that returns marked replies to their origin conversation. The graph follows the documented send-and-reply workflow and includes durable state/outbox handling, agent registry and IDE self-healing. README statements support the CLI and hook-server roles; source excerpts and the index support the shown provider, protocol, matching, state, and CDP relationships. Other documented capabilities are included, but unsampled implementations and links are not inferred.
Main entry points: hub.py Relay CLI · base.py CDP Backend · cc_connect.py cc-connect Provider · cdp_provider.py CDP Provider
Components 19
CLI and Discovery
- Relay CLI
hub.py - Agent Registry
hub.py - Generated Instructions
hub.py - Feishu Sender
bin/feishu-send.py
Relay Core
- Relay Envelope
core/envelope.py - Relay Protocol
core/relay_protocol.py - Reply Matcher
core/match.py - Relay State
core/state.py
Agent Delivery
- cc-connect Provider
providers/cc_connect.py - CDP Provider
providers/cdp_provider.py
Reply Handling
- Hook Server
hook-server.mjs
IDE Automation
- CDP Backend
cdp/backends/base.py - Antigravity Backend
cdp/backends/antigravity.py - Cursor Backend
cdp/backends/cursor.py - Selector Self-Healing
cdp/auto_heal.py
Other components
- Human or Agent
- cc-connect
- Origin Conversation
- Electron IDE
Connections 24
- Human or Agent → Relay CLI: commands
README.md - Relay CLI → Agent Registry: lists peers
README.md - Relay CLI → Generated Instructions: generates guidance
README.md - Relay CLI → Relay Envelope: creates task
hub.py - Relay CLI → Relay State: records relay
hub.py - Relay CLI → cc-connect Provider: dispatches task
hub.py - Relay CLI → CDP Provider: dispatches task
hub.py - cc-connect Provider → Relay Protocol: formats prompt
providers/cc_connect.py - CDP Provider → Relay Protocol: formats prompt
providers/cdp_provider.py - cc-connect Provider → cc-connect: posts webhook
providers/cc_connect.py - CDP Provider → CDP Backend: uses backend
providers/cdp_provider.py - CDP Backend → Antigravity Backend: specialized by
cdp/backends/antigravity.py - CDP Backend → Cursor Backend: specialized by
cdp/backends/cursor.py - CDP Backend → Electron IDE: controls via CDP
cdp/backends/base.py - CDP Backend → Selector Self-Healing: delegates healing
cdp/backends/base.py - Selector Self-Healing → CDP Backend: probes backend
cdp/auto_heal.py - cc-connect Provider → Reply Matcher: emits reply events
- CDP Provider → Reply Matcher: emits reply events
providers/cdp_provider.py - Relay CLI → Reply Matcher: matches replies
hub.py - Reply Matcher → Relay State: stores reply
core/match.py - cc-connect → Hook Server: sends hook event
README.md - Hook Server → Relay State: queues busy reply
- Hook Server → Origin Conversation: forwards reply
README.md - Relay CLI → Feishu Sender: supports messaging
README.md