How vfarcic/dot-agent-deck works
Agent Deck is a multi-agent coding-work coordinator: a background daemon owns agent sessions while terminal and desktop clients observe and control them. Users start agents or orchestrations, route delegated work through an inbox, and can dispatch isolated worktree units or schedule prompts; agents’ activity is surfaced back through shared clients. The graph also preserves remote-daemon access, telemetry, and desktop voice control. README statements support the product-level links; source-index references support only the sampled internal links, so unsampled internals are grouped conservatively.
Main entry points: daemon.rs Background daemon · agent_pty.rs Agent sessions · App.tsx Desktop app · ui.rs Terminal UI
Components 22
Daemon runtime
- Background daemon
src/daemon.rs - Agent sessions
src/agent_pty.rs - Agent events
src/event.rs - Daemon protocol
src/daemon_protocol.rs - Terminal input probe
src/composer_probe
Work coordination
- Orchestration context
src/orchestrator_context.rs - Delegation inbox
src/inbox.rs - Inbox delivery engine
src/inbox_engine.rs - Worktree dispatch
src/dispatch.rs - Scheduled tasks
src/scheduler.rs
User clients
- Terminal UI
src/ui.rs - Desktop app
desktop/src/App.tsx - Desktop runtime hook
desktop/src/hooks/useDeckRuntime.ts - Desktop daemon bridge
desktop/src/lib/bridge.ts - Voice commands
desktop/src-tauri/src/voice
Integrations
- Remote environments
src/remote.rs - Telemetry pipeline
src/telemetry/mod.rs - Agent hooks
src/hook.rs
Other components
- User
- Coding agents
- OTel backend
- Remote host
Connections 26
- User → Terminal UI: controls
- User → Desktop app: controls
- Terminal UI → Background daemon: controls shared agents
- Desktop app → Desktop runtime hook: uses runtime
desktop/src/App.tsx - Desktop runtime hook → Desktop daemon bridge: invokes
desktop/src/hooks/useDeckRuntime.ts - Desktop daemon bridge → Daemon protocol: communicates with
- Background daemon → Agent sessions: manages sessions
- Agent sessions → Coding agents: runs
- Agent sessions → Agent events: reports activity
src/event.rs - Background daemon → Daemon protocol: serves clients
- Background daemon → Orchestration context: composes spawn context
src/orchestrator_context.rs - Orchestration context → Delegation inbox: delegates work through
- Background daemon → Delegation inbox: owns inbox
src/inbox.rs - Background daemon → Inbox delivery engine: drives delivery
src/inbox_engine.rs - User → Worktree dispatch: requests isolated work
- Worktree dispatch → Agent sessions: starts work unit
- User → Scheduled tasks: sets prompt schedule
- Scheduled tasks → Background daemon: fires prompts
- Terminal UI → Remote environments: connects over SSH
- Desktop app → Remote environments: shows remote agents
- Remote environments → Remote host: connects to
- Background daemon → Telemetry pipeline: records runs
- Telemetry pipeline → OTel backend: exports records
- Coding agents → Agent hooks: reports lifecycle
- Desktop app → Voice commands: offers voice control
- Agent sessions → Terminal input probe: tracks terminal input
src/composer_probe/epoch.rs