A modern web-based remote UI for Claude Code, Cursor CLI, and OpenAI Codex.
Customized fork adapted from CloudCLI.
Access, manage, and collaborate with your coding agents from any device, anywhere.
RemoteCLI provides an intuitive, responsive web interface for local AI coding CLI tools like Claude Code, Cursor CLI, and OpenAI Codex.
Note: RemoteCLI is an enhanced and customized fork built upon the foundation of CloudCLI (cloudcli.ai), adding full zero-C++ build requirements (using pure Node.js
node:sqlite&bcryptjs), deep branding, optimized mobile controls, and customized multi-agent workflows.
Instead of being tethered to a single terminal window, RemoteCLI lets you monitor agent executions, edit files, inspect diffs, approve permissions, and run shell commands from any desktop browser, laptop, tablet, or mobile phone.
- ⚡ Zero C++ Build Tools Needed: Powered entirely by Node.js built-in
node:sqliteand pure-JavaScriptbcryptjs. No Visual Studio C++ Build Tools on Windows, no Xcode on macOS, and nonode-gypcompilation errors. - 🔄 Direct CLI & Config Sync: Reads and writes directly to your local configuration (
~/.claude). Your existing projects, session history, and MCP tools are discovered automatically. - 📱 Mobile & PWA Ready: Fully responsive mobile UI with touch navigation, virtual quick-keys, and iOS/Android home screen installation support.
- 🤖 Multi-Agent Support: Switch between Claude Code, Cursor CLI, and Codex within the same unified dashboard.
- 🔒 100% Local & Private: All data, sessions, and databases remain strictly on your own hardware. No external telemetry or cloud lock-in.
- Node.js:
>= 22.5.0(with built-innode:sqlite, zero C++ build tools required) - AI CLI: At least one supported AI CLI installed and authenticated on your machine:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Cursor CLI
- OpenAI Codex
- Claude Code:
Run RemoteCLI directly from npm with a single command:
npx @tunghuynh/remotecli@latestTo run on a specific port:
npx @tunghuynh/remotecli@latest --port 8080Install RemoteCLI globally on your machine for daily use:
npm install -g @tunghuynh/remotecliThen start RemoteCLI anytime simply by running:
remotecliOr start on a custom port:
remotecli --port 8080Once started, open your browser and navigate to:
👉 http://localhost:3001
- First Launch: Create your owner password to secure your local dashboard.
- Sync: RemoteCLI automatically discovers and syncs your local projects, sessions, git status, and MCP tools from
~/.claude.
To use RemoteCLI from your smartphone, tablet, or another laptop on your local network:
- Start RemoteCLI on your host machine:
remotecli
- Find your host machine's local IP address (e.g.,
192.168.1.50). - Open
http://<YOUR_LOCAL_IP>:3001in your mobile browser. - (Optional) Tap "Add to Home Screen" in Safari / Chrome for a standalone full-screen mobile app experience.
Tip: You can also use secure mesh networks like Tailscale or WireGuard to access your coding agents securely from anywhere outside your local network.
RemoteCLI features a built-in Remote Work architecture that allows you to access and control your coding agents from anywhere (via smartphone, tablet, or another laptop on 4G/5G or external Wi-Fi) without exposing public ports, setting up port-forwarding, configuring dynamic DNS, or running a VPN.
[ Controller (Phone / Laptop) ]
│
│ wss:// (End-to-End Encrypted binary frames - AES-256-GCM)
▼
[ Cloudflare Worker Relay ] (Dumb pipe: forwards opaque ciphertext, zero access to keys/data)
▲
│ wss:// (End-to-End Encrypted binary frames - AES-256-GCM)
│
[ Host (Your Workstation) ] ──▶ Claude Code / Cursor / Codex CLI
- Zero-Knowledge & End-to-End Encrypted: All communication between your Host (workstation) and Controller (remote device) is encrypted end-to-end using AES-256-GCM.
- Dumb Pipe Relay: The relay only forwards encrypted binary frames between paired rooms. It never sees encryption keys, authentication tokens, prompts, codebase contents, or credentials.
- Cost: Runs 100% within the Cloudflare Workers Free tier (100,000 requests/day, zero maintenance cost).
The relay server code is open-source and included in this repository:
📁 Relay Source Code: relay/ (Detailed spec: relay/README.md)
# Clone the repository
git clone https://github.com/tunghuynh/remote-cli.git
cd remote-cli/relay
# Install dependencies
npm ci --ignore-scripts
# Authenticate with Cloudflare (opens browser)
npx wrangler login(On headless VPS servers without a browser, you can alternatively set export CLOUDFLARE_API_TOKEN=<your-token>)
npx wrangler deployThe relay requires a strong shared secret (at least 32 characters) to guard against unauthorized access to your worker:
# Generate a cryptographically secure 43-character base64url secret
RELAY_SECRET=$(node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))")
# Store the secret in your Cloudflare Worker
echo "$RELAY_SECRET" | npx wrangler secret put RELAY_SECRETSave your Relay URL & Secret:
- Relay URL:
wss://<your-worker-name>.<your-subdomain>.workers.dev- Relay Secret: The generated
$RELAY_SECRETstring above.(You can verify that the relay is healthy by visiting
https://<your-worker-name>.<your-subdomain>.workers.dev/healthz, which will return HTTP 200)
- Start RemoteCLI:
remotecli
- Open
http://localhost:3001and navigate to Settings ➔ Remote work. - Under the Relay section:
- Enter your Relay URL:
wss://<your-worker-name>.<your-subdomain>.workers.dev - Enter your Relay secret.
- Click Save relay.
- Enter your Relay URL:
- Under Host settings:
- Toggle on Accept remote connections.
- Click Generate pairing code (a secure, single-use 6-digit or QR pairing code).
- Open your RemoteCLI web UI or desktop app on your remote device.
- In Settings ➔ Remote work, ensure the same Relay URL and Relay secret are saved.
- In the Hosts sidebar/tab, tap Pair host and enter the pairing code from your Host machine.
- 🎉 Connected! Your workstation will appear as an active host tab. You can now chat with Claude Code, approve permissions, inspect diffs, edit files, and run commands from anywhere in the world.
RemoteCLI - Command Line Tool
Usage:
remotecli [command] [options]
Commands:
start Start the RemoteCLI server (default)
status Show current configuration, paths, and database status
update Check and update RemoteCLI to the latest version
version Show installed package version
help Show CLI help and usage information
sandbox Manage Docker sandbox environments (experimental)
browser-use-mcp Run Browser MCP stdio server
Options:
-p, --port <port> Set server port (default: 3001)
--database-path <path> Set custom SQLite database path
-h, --help Show this help information
-v, --version Show version information
# Start on default port 3001
remotecli
# Start on a custom port
remotecli --port 8080
# Inspect configuration and database storage location
remotecli status
# Update to latest version
remotecli update| Variable | Description | Default |
|---|---|---|
SERVER_PORT |
Port the web server listens on | 3001 |
DATABASE_PATH |
Path to the SQLite storage database | ~/.remotecli/data.db (or application root) |
CLAUDE_CLI_PATH |
Custom path to the Claude Code CLI binary | claude |
CONTEXT_WINDOW |
Fallback context window token limit | 160000 |
Work with Claude Code, Cursor CLI, or OpenAI Codex within a single dashboard. RemoteCLI dynamically fetches available models at runtime, allowing you to choose the best model for your task.
Real-time response streaming, syntax-highlighted code blocks, unified diff viewers, and collapsible tool executions give you complete transparency into what the agent is doing.
Open full terminal sessions directly in the browser to run builds, test suites, or git operations alongside your agent conversations.
- File Explorer: Browse project directories, view file contents with syntax highlighting, and make quick edits.
- Git Integration: View modified files, inspect side-by-side diffs, stage files, switch branches, and commit changes.
All agent tools (such as Bash, Write, Edit, Glob, Grep) can be inspected, allowed, or blocked through the Tools Settings modal. Prevent unintended destructive commands from running automatically.
Add custom tabs with their own frontend components and backend services. Install community plugins or develop custom extensions for task queues, session intelligence, or custom dashboards.
- Node.js:
>= 22.5.0(with built-innode:sqlitesupport) - Operating System: Windows 10/11, macOS, or Linux
- AI CLI: At least one supported CLI installed on your machine:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Cursor CLI
- Codex
- Claude Code:
- Local Execution: RemoteCLI runs as a local web service on your machine.
- Your Own Credentials: RemoteCLI connects directly to your local CLI sessions; you use your own provider authentication.
- Permission Safety: Tool execution permissions match your security preferences and can be toggled per session or globally.
- 🐙 GitHub Repository: https://github.com/tunghuynh/remote-cli
- 📦 NPM Package: @tunghuynh/remotecli
- 🐛 Issue Tracker: Report issues or suggest features
This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).
Author: Tùng Huynh (@tunghuynh)