@yu_robotics/remote-cli

Remote control your Claude Code CLI from anywhere using your mobile phone through Feishu (Lark) messaging.

Features

• Remote Control: Control your local development environment from anywhere via mobile
• Secure: Directory whitelisting, command filtering, and device authentication
• Mobile-Optimized: Simplified commands and rich text formatting for Feishu
• Claude Code Integration: Full access to Claude Code's capabilities and context
• Persistent Process: Long-running Claude process with bidirectional streaming (no repeated spawn overhead)

Prerequisites

• Node.js >= 18.0.0
• Claude Code CLI installed and configured
• Access to a Feishu (Lark) bot connected to a remote-cli-router server

Installation

npm install -g @yu_robotics/remote-cli

Quick Start

1. Initialize

remote-cli init --server https://your-router-server.com

2. Bind Device in Feishu

Send the binding code to the Feishu bot:

/bind ABC-123-XYZ

3. Configure Allowed Directories

remote-cli config add-dir ~/projects ~/work

4. Start the Service

remote-cli start

5. Send Commands via Feishu

Help me fix TypeScript errors in ~/projects/my-app

Commands

| Command | Description | |---------|-------------| | remote-cli init -s <url> | Initialize and generate binding code | | remote-cli start | Start the background service | | remote-cli stop | Stop the service | | remote-cli status | Check service status | | remote-cli config show | View configuration | | remote-cli config add-dir <path> | Add allowed directory |

Feishu Bot Commands

Device Management

| Command | Description | |---------|-------------| | /bind <binding-code> | Bind a new device | | /status | View status of all devices | | /unbind | Unbind all devices | | /device | List all your bound devices | | /device list | List all your bound devices | | /device switch <device-id-or-index> | Switch to a specific device | | /device <device-id-or-index> | Quick switch to a device | | /device unbind <device-id-or-index> | Unbind a specific device | | /help | Show help information |

Claude Code Commands

All commands/skills supported by local Claude Code are passed through directly, for example:

• /commit - Commit code changes
• /review - Code review
• /test - Run tests
• /clear - Clear current session
• And all other built-in Claude Code commands

Security

• Directory whitelisting: Only explicitly allowed directories are accessible
• Command filtering: Dangerous commands are automatically blocked
• Device authentication: Each device has a unique hardware-based ID
• Binding codes: Expire after 5 minutes

Documentation

For full documentation including router server deployment, see the project README.

License

MIT