From Pocket Claudes
Use when the user asks about installing, configuring, troubleshooting, or understanding the Pocket Claudes plugin — the Claude Code plugin that visualizes live sessions as desktop NPCs by pairing with the PocketClaudes Unity 6 overlay game.
How this skill is triggered — by the user, by Claude, or both
Slash command
/pocket-claudes:pocket-claudesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Claude Code plugin. Pairs with the **PocketClaudes** Unity 6 desktop overlay game (separate download). Each running Claude Code session → one NPC walking on the user's desktop. Hooks here forward event metadata over loopback HTTP; the game renders the NPCs and animates them per event.
Claude Code plugin. Pairs with the PocketClaudes Unity 6 desktop overlay game (separate download). Each running Claude Code session → one NPC walking on the user's desktop. Hooks here forward event metadata over loopback HTTP; the game renders the NPCs and animates them per event.
The plugin alone does nothing visible — the game is the renderer. The game alone does nothing — the plugin is its only data source.
hooks/hooks.json registers 14 hook events. Each event runs one command: bash scripts/hook-event.sh || powershell ... scripts/hook-event.ps1 — bash first (macOS/Linux), PowerShell fallback (Windows). No external runtime dep.hostPid, builds a flat versioned IpcCommand, and POSTs to http://127.0.0.1:1604/.session_id lazily spawns the NPC; unknown agent_id lazily spawns a mini NPC; duplicate SessionStart reuses. So SessionStart is an optimization, never a precondition — the first event delivered to a running game spawns the NPC regardless of type.Hook forwards only: eventName, sessionId, agentId, agentType, toolName, toolUseId, model, cwd, hostPid. Never prompt text, tool inputs/results, file contents, command output, Claude responses, or transcript path. Game listens on 127.0.0.1:1604 only — no outbound network. Both scripts are <100 lines; audit them directly.
1604 is in use (fixed, no discovery). Kill the conflicting process; check netstat -ano | findstr :1604 (Windows) or lsof -i :1604 (mac/Linux).hostPid resolution failed. Linux needs xdotool; macOS uses osascript; Windows uses Win32_Process. Install missing tool and restart the session.Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub teambaconn/pocketclaudes --plugin pocket-claudes