This project provides a remote control interface for Claude Code, enabling users to initiate tasks, receive notifications, and send new commands via email, Telegram, and LINE. It targets developers who need to manage long-running AI tasks or collaborate across different locations, offering a flexible and accessible way to interact with Claude Code from anywhere.

How It Works

The system leverages webhooks and background daemons to bridge Claude Code's execution with messaging platforms. When Claude Code completes a task or reaches a specific state, it triggers a hook. This hook then sends a notification through the configured channels (Email, Telegram, LINE), including execution traces for email. Users can reply to these notifications or use specific commands within the messaging platforms to send new instructions back to Claude Code, which are then injected into the active tmux session.

Quick Start & Requirements

• Installation: Clone the repository, run npm install.
• Prerequisites: Node.js >= 14.0.0, tmux (required for command injection), an active tmux session with Claude Code running.
• Configuration: Set up environment variables for your chosen messaging platform (Email, Telegram, or LINE) in a .env file. Configure Claude Code hooks to point to the provided notification scripts.
• Running: Start services using npm run webhooks (all platforms) or individual commands like npm run telegram.
• Documentation: Demo Video, Quick Start

Highlighted Details

• Supports Email (with execution trace), Telegram (interactive buttons), and LINE messaging.
• Features two-way control, allowing commands to be sent by replying to notifications.
• Includes security measures like sender whitelisting and session tokens.
• Offers group support for LINE and Telegram.
• Integrates with tmux for seamless command injection.

Maintenance & Community

The project is actively maintained, with recent updates in August 2025 addressing execution traces, multi-channel notifications, and bug fixes. Users can follow @Jiaxi_Cui on Twitter for updates.

Licensing & Compatibility

The project is released under the MIT License, allowing for free use and modification, including in commercial or closed-source projects.

Limitations & Caveats

Claude Code must be running within a tmux session for command injection to function. While email notifications can include detailed execution traces, this may lead to verbose emails, and users can configure to exclude them. Discord and Slack integrations are listed as future TODO items.