How oncas/agent-deck works
Agent Deck is a desktop workspace for running AI coding agents across Git repositories, reviewing changes, and using project tools. The main flow is Electron launching the local Go service, whose HTTP and WebSocket interfaces serve the UI and manage project sessions and terminals. Distinct capabilities include workspace management, Git and worktree operations, scheduled jobs, database browsing, usage reporting, and integrations. The graph follows documented capabilities and shown wiring; many feature-specific API routes and UI interactions were not excerpted, so those links are omitted or marked unverified.
Main entry points: server.go HTTP API server · main.go Backend startup · database.go Database browser · manager.go Session manager
Components 33
Desktop and UI
- Electron shell
electron/main.js - Agent Deck UI
cmd/agentdeck/static/app.js - Terminal controls
cmd/agentdeck/static/terminal_interactions.js - Terminal transport
cmd/agentdeck/static/terminal_transport.js
Server runtime
- HTTP API server
internal/server/server.go - Backend startup
cmd/agentdeck/main.go - App configuration
internal/config/config.go
Agent sessions
- Session manager
internal/pty/manager.go - PTY process
internal/pty/session.go - Session status
internal/pty/status.go - Terminal WebSocket
internal/server/websocket.go - Scheduled jobs
internal/server/jobs.go
Projects and Git
- Repository discovery
internal/scanner/scanner.go - Workspaces
internal/server/workspaces.go - Git operations
internal/server/git.go - Git worktrees
internal/server/worktree.go - Background fetch
internal/server/fetcher.go
Project tools
- Database browser
internal/server/database.go - Database saved state
internal/server/database_store.go - Database state
internal/server/database_state.go - Docker stacks
internal/server/docker.go - Agent usage
internal/server/usage.go - Claude usage
internal/server/claude_usage.go - Codex usage
internal/server/codex_usage.go - Usage limits
internal/server/usage_limits.go - Forge activity
internal/server/forge.go - GitHub activity
internal/server/github.go - GitLab activity
internal/server/gitlab.go - Keep-awake control
internal/server/power.go
Other components
- Desktop user
- AI CLI processes
- PostgreSQL, MySQL, SQLite
- GitHub and GitLab
Connections 40
- Desktop user → Electron shell: uses
- Electron shell → Backend startup: launches
- Electron shell → HTTP API server: polls readiness
electron/main.js - Electron shell → Keep-awake control: polls power
electron/main.js - Agent Deck UI → HTTP API server: uses API
- Terminal controls → Terminal transport: controls
- Terminal transport → Terminal WebSocket: exchanges terminal data
- Backend startup → App configuration: loads
- Backend startup → Repository discovery: discovers projects
- Backend startup → Session manager: creates
cmd/agentdeck/main.go - Backend startup → HTTP API server: starts
cmd/agentdeck/main.go - HTTP API server → Workspaces: routes workspace requests
internal/server/server.go - HTTP API server → Terminal WebSocket: routes terminal sockets
internal/server/server.go - HTTP API server → Scheduled jobs: handles job requests
- HTTP API server → Git operations: routes Git actions
- HTTP API server → Git worktrees: routes worktree actions
- HTTP API server → Database browser: routes database requests
- HTTP API server → Docker stacks: routes Docker requests
- HTTP API server → Agent usage: routes usage requests
- HTTP API server → Forge activity: routes forge requests
- HTTP API server → Keep-awake control: serves power state
- Session manager → PTY process: creates and manages
internal/pty/manager.go - Session manager → Session status: queries status
internal/pty/manager.go - PTY process → AI CLI processes: runs
internal/pty/session.go - Terminal WebSocket → Session manager: accesses sessions
- Scheduled jobs → Session manager: runs scheduled prompts
- Database browser → Database saved state: persists saved state
internal/server/database.go - Database browser → Database state: loads connection state
- Database browser → PostgreSQL, MySQL, SQLite: queries
internal/server/database.go - Database browser → Database saved state: resolves passwords
- Agent usage → Claude usage: reads Claude logs
- Agent usage → Codex usage: reads Codex logs
- Agent usage → Usage limits: reports limits
- Forge activity → GitHub activity: uses GitHub activity
- Forge activity → GitLab activity: uses GitLab activity
- GitHub activity → GitHub and GitLab: queries gh
- GitLab activity → GitHub and GitLab: queries glab
- Git operations → Background fetch: refreshes status
- Git operations → Git worktrees: supports worktree actions
- Docker stacks → AI CLI processes: independent project tool