Claude Remote Watchdog — Development skill for Claude Code

claude-remote-watchdog

Auto-detect and fix dead [Claude Code](https://docs.anthropic.com/en/docs/claude-code) Remote Control (`/remote-control`) sessions in tmux.

The Problem

Claude Code's `/remote-control` silently drops connections after 15-60 minutes. The built-in reconnection never recovers — the status bar shows "Remote Control reconnecting" indefinitely. The only fix is to manually cycle `/remote-control` at the terminal, which defeats the purpose of remote control.

See: [anthropics/claude-code#34255](https://github.com/anthropics/claude-code/issues/34255)

How It Works

1. Scans all tmux panes for Claude Code's status bar
2. Detects Remote Control reconnecting (stuck/dead state)
3. Uses a 2-check grace period to avoid false positives on transient drops
4. Sends tmux keystrokes to automatically cycle disconnect → reconnect:
   • Ctrl+C → clear prompt
   • /remote-control → navigate to "Disconnect this session" → Enter
   • /remote-control → auto-connects to fresh bridge session

Requirements

• Claude Code CLI
• tmux (sessions must run inside tmux panes)

Install

git clone https://github.com/sma1lboy/claude-remote-watchdog.git
cd claude-remote-watchdog
./install.sh

This creates symlinks in `~/.claude/`:

• ~/.claude/commands/remote-watchdog.md — slash command
• ~/.claude/scripts/remote-watchdog.sh — watchdog script

Usage

Inside Claude Code (recommended)

# One-time health check
/remote-watchdog

# Auto-monitor every 5 minutes
/loop 5m /remote-watchdog

Standalone (no Claude session needed)

# Manual run
~/.claude/scripts/remote-watchdog.sh

# Dry run (detect only, no reconnect)
~/.claude/scripts/remote-watchdog.sh --dry-run

# Crontab (fully autonomous)
*/5 * * * * ~/.claude/scripts/remote-watchdog.sh >> /tmp/remote-watchdog.log 2>&1

Output

=== Remote Control Watchdog 10:48:42 ===
[HEALTHY] Deck (%4)
[WARN] agent-universe (%5):