Remote control your running Claude Code / Pi Agent CLI sessions via Feishu or Telegram. Walk away from your computer and keep interacting with your Agent from your phone.
- Seamless terminal experience — desktop CLI keeps full ANSI formatting, colors, and interactivity; remote control has zero impact
- Multi-platform IM — supports Feishu (WebSocket) and Telegram (Bot API) simultaneously
- Multi-Agent — Claude Code and Pi Agent, switch with
/change - Slash commands —
/status,/list,/switch,/mute,/p,/allow,/answer, etc. - Remote permission approval — tool permission requests pushed to IM, respond with
/allow,/deny,/always - Remote Q&A — AskUserQuestion pushed as cards, reply with
/answer N - Desktop floating widget — always-on-top icon with status color, expandable session list
- Sound alerts — configurable sounds on idle and permission events
- Auto hook installation — Claude Code hooks configured automatically on startup
- No public IP needed — Feishu WebSocket + Telegram long polling, client-initiated connections
Download the latest release from GitHub Releases. See Usage Guide for configuration details.
After mounting the DMG and dragging the app to Applications, macOS Gatekeeper may report the app as "damaged" because it is not code-signed. Run the following command to fix it:
xattr -cr /Applications/CC\ Remote\ Seamless.appThen open the app normally.
Run the .exe installer directly. No extra steps needed.
- Rust toolchain (stable)
- Node.js 20+
- Go 1.22+
# 1. Clone the repository
git clone https://github.com/Oak-Thorn/cc_remote_seamless.git
cd cc_remote_seamless
# 2. Install frontend dependencies
npm ci
# 3. Build the sidecar (Feishu gateway)
cd sidecar/feishu-gateway
go build -o feishu-gateway-aarch64-apple-darwin . # macOS Apple Silicon
# go build -o feishu-gateway-x86_64-apple-darwin . # macOS Intel
# GOOS=windows GOARCH=amd64 go build -o feishu-gateway-x86_64-pc-windows-msvc.exe . # Windows
cd ../..
# 4. Build the Tauri app
npm run tauri build| Platform | Path |
|---|---|
| macOS .app | target/release/bundle/macos/CC Remote Seamless.app |
| macOS .dmg | target/release/bundle/dmg/CC Remote Seamless_<ver>_aarch64.dmg |
| Windows .msi | target/release/bundle/msi/*.msi |
| Windows .exe | target/release/bundle/nsis/*.exe |
npm run tauri devCreate ~/.cc-remote/config.toml:
[general]
hook_port = 23399
[platforms.feishu-main]
type = "feishu"
app_id = "cli_xxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxx"
chat_id = "oc_xxxxxxxxxxxxxxxxxxxxxxxx"
[agents.claude-code]
platforms = ["feishu-main"]| Command | Description |
|---|---|
/status |
View current session status |
/list |
List all active sessions |
/switch <id> |
Switch to specified session |
/change [agent] |
Switch agent type |
/p <text> |
Send prompt |
/mute / /unmute |
Mute/unmute message push |
/allow / /deny / /always |
Permission approval |
/answer <n> |
Answer a question |
/radar |
Re-discover running agents |
/stop |
Stop session |
/help |
Show help |
┌─────────────────────────────────────────────────────┐
│ CC Remote Seamless (Tauri 2 + Vue 3 + Rust) │
│ │
│ ┌─────────┐ ┌────────┐ ┌───────────────────┐ │
│ │ Float UI│ │ Engine │ │ Hook Server :23399│ │
│ │ (Widget)│←→│(Router)│←─│ │←── Claude Code / Pi hooks
│ └─────────┘ └────────┘ └───────────────────┘ │
│ ↕ │
│ ┌─────────────────────────────────────────────┐ │
│ │ Agents: ClaudeCode | Pi │ │
│ └─────────────────────────────────────────────┘ │
│ ↕ │
│ ┌─────────────────────────────────────────────┐ │
│ │ Platforms: Feishu (Go sidecar, WebSocket) │ │
│ │ Telegram (reqwest, long poll) │ │
│ └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘
GitHub Actions automatically builds for macOS (aarch64 + x86_64) and Windows (x86_64) on tag push or manual trigger. See .github/workflows/build.yml.