Claude-Control: Mobile Remote Control for Claude Code Sessions

Claude-control is an open-source mobile remote control for Claude Code that addresses the problem of sessions idling while you're away from your desk. The tool enables control of Claude Code sessions from your phone using HTTPS and WebSocket connections.

How It Works

The system uses a Node.js server with Express, node-pty, and tmux running on your machine. A React client with xterm.js renders the terminal in your browser, while WebSocket streams PTY output in real time. Sessions live in tmux, ensuring both your terminal and phone display the same content.

Key Features

• Runs Claude Code in a real PTY (required for interactive mode) inside tmux
• Detects permission prompts and sends push notifications to your phone
• Provides Allow/Deny buttons directly from notifications or within the app
• Includes tiling window manager for multiple concurrent sessions
• Supports voice input via Web Speech API
• PWA installable on iPhone/Android without app store requirements
• CLI tool (cc) to create, list, attach, and kill sessions

Technical Details

The tool works on macOS and Linux, with Windows support available via WSL. The GitHub repository contains the complete source code and documentation for setup and usage.

This type of tool is useful for developers who use AI coding assistants and need to manage sessions remotely, particularly when Claude Code requires permission prompts that would otherwise stall progress.