Claude Code Monitor

Claude Code Monitor

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

Terminal UI
Monitor sessions with keyboard navigation

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

✨ Features

- 🔌 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)

Or install globally

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)

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

Options

Keybindings

Status Icons

📱 Mobile Web Interface

Monitor and control Claude Code sessions from your smartphone.

Features

- Real-time session status via WebSocket
- View latest Claude messages
- Focus terminal sessions remotely
- Send text messages to terminal (multi-line supported)
- Permission prompt navigation - Respond to…