How adrirubio/claude-deck works
Claude Deck is a self-hosted web console for inspecting and managing local AI-coding-agent workspaces. Users enter through the dashboard, select a provider or project, manage configuration and extensions, and inspect or coordinate agent sessions; results affect local files, CLI sessions, and persisted coordination data. The graph preserves the README’s major feature areas while grouping related screens and API domains. Some backend services are unsampled, so their links are marked unverified rather than presented as inspected call paths.
Main entry points: App.tsx Claude Deck UI · router.py Versioned API · agent_teams.py Team endpoints · agent_mail.py Mail endpoints
Components 29
Web entry
- Claude Deck UI
frontend/src/App.tsx
Workspace management
- Provider config
frontend/src/features/config/ConfigViewerPage.tsx - Agent extensions
frontend/src/features/mcp/MCPServersPage.tsx - Projects and backups
frontend/src/features/projects/ProjectsPage.tsx - Agents and skills
frontend/src/features/agents/AgentsPage.tsx
Agent coordination
- Agent Mail
frontend/src/features/agent-mail/AgentMailPage.tsx - Agent Teams
frontend/src/features/agent-teams/AgentTeamsPage.tsx - Agent Bridge
frontend/src/features/cc-bridge/CCBridgePage.tsx - Mail endpoints
backend/app/api/v1/agent_mail.py - Team endpoints
backend/app/api/v1/agent_teams.py - Bridge endpoints
backend/app/api/v1/agent_bridge/router.py - CC Bridge endpoints
backend/app/api/v1/cc_bridge/router.py
History and insight
- Session transcripts
frontend/src/features/sessions/SessionViewPage.tsx - Context and usage
frontend/src/features/context/ContextPage.tsx
Backend runtime
- Versioned API
backend/app/api/v1/router.py - Config endpoints
backend/app/api/v1/config.py - MCP endpoints
backend/app/api/v1/mcp.py - Agent endpoints
backend/app/api/v1/agents.py - History endpoints
backend/app/api/v1/sessions.py - Transcript analysis
backend/app/services/session_service.py - Context analysis
backend/app/services/context_service.py - Mail coordination
backend/app/services/agent_mail_service.py - Team orchestration
backend/app/services/agent_team_service.py - Session discovery and relay
backend/app/services/cc_bridge/pty_relay.py - SQLite state
backend/app/models/database.py
Other components
- Local operator
- Agent config and history files
- Local agent CLIs
- GitHub
Connections 36
- Local operator → Claude Deck UI: uses
README.md - Claude Deck UI → Versioned API: requests
- Claude Deck UI → Provider config: routes to
frontend/src/App.tsx - Claude Deck UI → Agent extensions: routes to
frontend/src/App.tsx - Claude Deck UI → Projects and backups: routes to
frontend/src/App.tsx - Claude Deck UI → Agents and skills: routes to
frontend/src/App.tsx - Claude Deck UI → Agent Mail: routes to
frontend/src/App.tsx - Claude Deck UI → Agent Teams: routes to
frontend/src/App.tsx - Claude Deck UI → Agent Bridge: routes to
frontend/src/App.tsx - Claude Deck UI → Session transcripts: routes to
frontend/src/App.tsx - Claude Deck UI → Context and usage: routes to
frontend/src/App.tsx - Versioned API → Config endpoints: registers
backend/app/api/v1/router.py - Versioned API → MCP endpoints: registers
backend/app/api/v1/router.py - Versioned API → Agent endpoints: registers
backend/app/api/v1/router.py - Versioned API → Mail endpoints: registers
backend/app/api/v1/router.py - Versioned API → Team endpoints: registers
backend/app/api/v1/router.py - Versioned API → Bridge endpoints: registers
backend/app/api/v1/router.py - Versioned API → CC Bridge endpoints: registers
backend/app/api/v1/router.py - Versioned API → History endpoints: registers
backend/app/api/v1/router.py - History endpoints → Transcript analysis: calls
backend/app/api/v1/sessions.py - Context analysis → Agent config and history files: reads
backend/app/services/context_service.py - Transcript analysis → Agent config and history files: reads
backend/app/services/session_service.py - Bridge endpoints → Session discovery and relay: uses
backend/app/api/v1/agent_bridge/router.py - CC Bridge endpoints → Session discovery and relay: relays via
backend/app/api/v1/cc_bridge/router.py - Team endpoints → Team orchestration: calls
backend/app/api/v1/agent_teams.py - Team endpoints → Mail coordination: calls
backend/app/api/v1/agent_teams.py - Mail endpoints → Mail coordination: calls
backend/app/api/v1/agent_mail.py - Mail endpoints → SQLite state: queries
backend/app/api/v1/agent_mail.py - Team endpoints → SQLite state: queries
backend/app/api/v1/agent_teams.py - Config endpoints → Agent config and history files: manages
- MCP endpoints → Agent config and history files: manages
- Agent endpoints → Agent config and history files: manages
- Session discovery and relay → Local agent CLIs: discovers sessions
- Team orchestration → Local agent CLIs: launches sessions
- Team orchestration → GitHub: coordinates dispatch
- Mail coordination → SQLite state: persists coordination