Documentation
README
AgentDeck Diagnostic Skill
Canonical diagnostic procedure for AgentDeck bridge synchronization issues between device displays and agent terminals (cursor desync, false idle, stale options, action dispatch races, hook ingestion gaps, state-machine regressions). This file is the single source of truth — .claude/skills/sdc-diagnose.md is a thin pointer to it.
Step 1: Collect Diagnostic Data
From the repo root, try the live bridge first:
cd /Users/puritysb/github/AgentDeck
agentdeck diag --tail 500 2>/dev/null || echo "Bridge not running — using journal files directly"
If the bridge isn't running, read journal/log files directly:
This is the opening of the README. Read the full README on GitHub.