Claude Code Monitor

Monitor multiple Claude Code sessions in real-time from your terminal or smartphone.

Terminal UI

Monitor sessions with keyboard navigation

<p align="center"> <img src="https://raw.githubusercontent.com/onikan27/claude-code-monitor/main/docs/ccm-demo.gif" alt="Terminal UI Demo" width="800"> </p>

Mobile Web

Control from your phone (same Wi-Fi or Tailscale)

<p align="center"> <img src="https://raw.githubusercontent.com/onikan27/claude-code-monitor/main/docs/mobile-web-demo.gif" alt="Mobile Web Demo" width="800"> </p>

---

✨ Features

| Terminal (TUI) | Mobile Web | |----------------|------------| | Real-time session monitoring | Monitor from your smartphone | | Quick tab focus with keyboard | Remote terminal focus | | Vim-style navigation | Send messages to terminal | | Simple status display | Permission prompt navigation | | | Screen capture with pinch zoom |

• 🔌 Serverless - File-based state management, no API server required
• ⚡ Easy Setup - One command ccm for automatic setup and launch
• 🔒 Secure - No external data transmission, token-based mobile auth

---

📋 Requirements

Note: This tool is macOS only due to its use of AppleScript for terminal control.

• macOS
• Node.js >= 18.0.0
• Claude Code installed

---

🚀 Quick Start

Run with npx (no install required)

npx claude-code-monitor

Or install globally

npm install -g claude-code-monitor
ccm

On first run, it automatically sets up hooks and launches the monitor.

Mobile Access

1. Press h to show QR code (default port: 3456)
2. Scan with your smartphone (same Wi-Fi required)

If port 3456 is in use, an available port is automatically selected.

Remote Access with Tailscale

Access from anywhere using Tailscale (secure VPN).

Prerequisites:

1. Install Tailscale on your Mac and smartphone
2. Sign in with the same Tailscale account on both devices
3. Ensure Tailscale is connected (check menu bar icon)

# Start with Tailscale IP
npx claude-code-monitor -t

# Or if installed globally
ccm -t

With -t option, the QR code URL uses your Tailscale IP (100.x.x.x), allowing access from any device in your Tailnet - even outside your local network.

Security: Tailscale uses WireGuard encryption. Communication is secure even over public networks.

---

📖 Usage

Commands

| Command | Alias | Description | |---------|-------|-------------| | ccm | - | Launch monitor (auto-setup if needed) | | ccm watch | ccm w | Launch monitor | | ccm serve | ccm s | Start mobile web server only |...