How chenhg5/cc-connect works
cc-connect connects chat platforms and a web dashboard to local coding agents, routing user requests into project-specific sessions and returning agent output to the initiating channel. The main runtime also exposes management, scheduled automation, webhooks, and a browser-based control surface. The README excerpt confirms the local-project chat workflow and broad platform support; sampled source confirms startup wiring, the web API client, bridge socket, and webhook behavior. Platform and agent internals are represented by their source directories because their implementations were not sampled.
Main entry points: main.go CLI runtime · engine.go Project engine · App.tsx Admin dashboard · platform Chat adapters
Components 19
Core runtime
- CLI runtime
cmd/cc-connect/main.go - Configuration
config/config.go - Project engine
core/engine.go - Plugin registry
core/registry.go - Session handling
core/session.go
Chat channels
- Chat adapters
platform - Web chat bridge
core/bridge.go
Coding agents
- Agent integrations
agent
Automation
- Webhook intake
core/webhook.go - Scheduled tasks
core/cron.go - Daemon manager
daemon/manager.go
Web management
- Admin dashboard
web/src/App.tsx - Web API client
web/src/api/client.ts - Management API
core/api.go
Other components
- Chat user
- Web admin
- Local agent CLIs
- Browser
- Chat services
Connections 20
- Chat user → Chat services: sends request
- Chat services → Chat adapters: delivers message
- Chat adapters → Project engine: forwards message
- CLI runtime → Configuration: loads settings
- CLI runtime → Plugin registry: creates plugins
- CLI runtime → Project engine: creates engines
- Project engine → Session handling: manages session
- Project engine → Agent integrations: dispatches work
- Agent integrations → Local agent CLIs: runs locally
- Project engine → Chat adapters: sends reply
- CLI runtime → Web chat bridge: starts and registers
- Admin dashboard → Web API client: calls API
- Web API client → Management API: HTTP requests
- Browser → Admin dashboard: uses dashboard
- Admin dashboard → Web chat bridge: connects by socket
- CLI runtime → Webhook intake: starts and registers
- Webhook intake → Project engine: dispatches prompt
- CLI runtime → Scheduled tasks: registers engines
- Scheduled tasks → Project engine: runs scheduled work
- CLI runtime → Daemon manager: manages service