mkober

Agent Debug — Development skill for Claude Code

Development community

Debug agent issues by capturing tmux pane content and checking agent status.

How to install Agent Debug

Installs to ~/.claude/skills/mkober-muxcode-agent-debug/SKILL.md

Terminal

mkdir -p ~/.claude/skills/mkober-muxcode-agent-debug && curl -fsSL https://raw.githubusercontent.com/mkober/muxcode/HEAD/skills/agent-debug.md -o ~/.claude/skills/mkober-muxcode-agent-debug/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Agent Debug does

name: agent-debug description: Debug agent issues by capturing tmux pane content and checking agent status roles: [edit] tags: [debug, tmux, agents]

Agent debugging via tmux capture-pane

Use these techniques to inspect what other agents are doing, verify message delivery, and diagnose stuck agents.

Scope — liveness, never results

These techniques answer **"is that agent alive, idle, wedged, or crashed?"** They are never a way to read what an agent *concluded*. Results arrive a

Alternatives in Development

Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
Debug Bson — Debug BSON Serialization Issues 115 ★
State Analyzer — You are a terminal state analyzer for Omux 94 ★