Agent Deck Documentation
Technical guides, runtime configuration, and integration specifications for orchestrating autonomous local AI coding clusters with sub-millisecond tactile feedback.
Local Host & Hardware Topology
Platform Packages & CLI Binaries
Choose your operating system to install the Agent Deck runtime daemon and HUD overlays.
brew install --cask agent-deck
Native binary signed and notarized by Apple Developer ID.
Requires Terminal Accessibility API permissions for process tree telemetry.
The "Unknown" Operational Data Guarantee
Agent Deck never estimates, interpolates, or guesses token consumption. If an LLM provider or local runner does not emit factual usage metrics through its process hooks, the UI strictly displays "Unknown". Developers require deterministic operational telemetry to make production deployment choices, not simulated heuristics or synthetic graphs.
Connecting Local AI Agents
The local Agent Deck daemon silently monitors your shell sessions, detecting agent loops in sub-millisecond cycles without injecting invasive proxy wrappers.
Automatic Process Inspection
When you run claude, copilot, or background agent processes in iTerm, Terminal, Alacritty, or VS Code, our eBPF/Mach kernel probe detects spawned child threads and connects to their stdio pipe instantaneously.
Agent Protocol Hook Config
For custom agent frameworks (LangGraph, CrewAI, AutoGen), emit formatted JSON events over Unix socket /tmp/agentdeck.sock or stdout to expose custom step checkpoints.
{ "version": "2.14", "daemon": { "socket": "/tmp/agentdeck.sock", "poll_interval_ms": 400, "unknown_policy_strict": true }, "agents": [ { "name": "claude-code", "binary_match": "claude", "intercept_approval": true, "tactile_deck_assign": 1 }, { "name": "cursor-composer", "binary_match": "Cursor", "intercept_approval": false } ] }
The Floating Edge Widget & Ring Thresholds
Configure screen placement, collapse sensitivity, and interpret telemetry rings at a glance.
Mint illumination. Normal token consumption rate, sub-agent executing without throttling.
Amber illumination. Rate limit ceiling approaching. The Deck emits tactile micro-clicks on rotary dial.
Critical Red or Striped grey for "Unknown". Execution stops until user approves extra token bucket via hardware button.
The Deck Console Configuration
When connected over USB-C, The Deck operates as an ultra-low latency HID controller with physical mechanical keycaps for approving or killing autonomous agent bash commands.
Accept / Reject Triggers
The green mechanical Kailh Choc switch delivers an instant Enter response to the active CLI process. The red switch issues an immediate SIGINT (Ctrl+C) followed by session termination, preventing runaway loops.
Rotary Encoder Detents
Turn the CNC-machined aluminium dial to switch focus between concurrent AI coding clusters (e.g., frontend worker vs backend tester). The high-density OLED display on the deck faceplate changes color dynamically per agent state.
Diagnostic FAQ & Edge Cases
How do I resolve daemon port or socket conflicts? expand_more
127.0.0.1:4499 and socket /tmp/agentdeck.sock. If another process has claimed the port, specify an alternative port in your config or execute: agentdeck daemon --port 5020 --socket /tmp/agentdeck-custom.sock
Does Agent Deck read private repositories or source files? expand_more
What happens if a background agent process crashes? expand_more
SIGSEGV 139). The Deck hardware pulses its red LED warning ring, allowing you to hit the tactile Reject trigger to dismiss or auto-restart the run loop.
Pricing & Bundles
Explore Community edition vs Pro hardware pre-orders.
Firmware Changelog
v2.14.9 includes Apple M3 Max low-jitter eBPF hooks.
GitHub Repository
Inspect daemon source, contribute plugins, and report RFC tickets.