debug

Remote Docker Debugger

Execute commands inside a Docker container from the host using the file-based command relay.

Read tools/debugger/CLAUDE.md for full usage details — it has the protocol and examples.

Quick Reference

# Check connection
bash tools/debugger/client.sh status

# Connect to server (user must start server.sh in Docker first)
bash tools/debugger/client.sh handshake

# Run a command
bash tools/debugger/client.sh run "<command>"

Long-running command (default timeout is 600s)

bash tools/debugger/client.sh --timeout 1800 run ""

Cancel the currently running command

bash tools/debugger/client.sh cancel

Reconnect after server restart

bash tools/debugger/client.sh flush bash tools/debugger/client.sh handshake