RTB 2.0 -- Remote Terminal Bridge

中文文档

A high-performance remote terminal bridge built in Rust, providing web-based terminal access with AI agent integration and a plugin-driven architecture.

Features

• Remote terminal access -- Full terminal sessions via web browser and mobile
• AI Agent management -- Connect and manage AI agents through the ACP (Agent Communication Protocol)
• Plugin architecture -- Extensible IM integrations (Feishu, Telegram, Discord) and tunnel providers
• Smart notifications -- 3-layer detection engine (keyword, regex, semantic) for intelligent alerting
• Task pool -- Auto-scheduling task queue with priority management
• Modern UI -- Dark/light theme, command palette (Ctrl+K), keyboard shortcuts
• Single binary -- Self-contained distribution with embedded frontend assets

Architecture

+------------------+     +------------------+
|   CLI (clap)     |     |   Tauri Desktop  |
+--------+---------+     +--------+---------+
         |                        |
         +----------+-------------+
                    |
         +----------v-----------+
         |    Server (Axum)     |
         |  REST + WebSocket    |
         +----------+-----------+
                    |
         +----------v-----------+
         |        Core          |
         |  +------+ +-------+ |
         |  |Event | | PTY   | |
         |  | Bus  | |Manager| |
         |  +------+ +-------+ |
         |  +------+ +-------+ |
         |  |Agent | |Session| |
         |  |  ACP | | Store | |
         |  +------+ +-------+ |
         |  +------+ +-------+ |
         |  |Notif.| | Task  | |
         |  |Engine| | Pool  | |
         |  +------+ +-------+ |
         +-----------+----------+
                     |
         +-----------v----------+
         |    Plugin Host       |
         |  IM / Tunnel plugins |
         +----------------------+

Quick Start

# Build the frontend
cd web && npm install && npm run build && cd ..

# Build the Rust binary
cargo build --release -p rtb-cli

# Run
./target/release/rtb-cli

Then open your browser at http://localhost:9399.

Or use the Makefile:

make dev      # Start in dev mode (builds plugins automatically)
make build    # Build frontend + plugins + release binary
make install  # Build and install to /usr/local/bin/rtb

CLI Usage

rtb                  # Start the RTB server (foreground)
rtb start -d         # Start as background daemon
rtb stop             # Stop the daemon
rtb status           # Show server status

Plugins

Cloudflare Tunnel

Automatically creates a public URL via cloudflared quick tunnel on startup. No Cloudflare account needed.

brew install cloudflared   # Install once
make dev                   # Tunnel starts automatically

Feishu (Lark) IM

Connects to Feishu via WebSocket long connection to receive and send messages. Configure credentials:

export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"
make dev

Feishu Open Platform setup:

1. Create an enterprise app
2. Event subscription -> select "Use long connection to receive events"
3. Add event: im.message.receive_v1

IM Commands

Send messages to the Feishu bot to interact with AI agents:

Command	Description
(any text)	Chat with the current agent (auto-creates one if none)
/new [provider]	Create a new agent (default: claude-code)
/list	List all agents with numbered index
/switch N	Switch to agent #N
/help	Show available commands

Agent output (text, tool use, progress, errors) is automatically forwarded to the Feishu chat.

Tech Stack

Layer	Technology
Backend	Rust, Tokio, Axum, portable-pty
Frontend	React 19, TypeScript, Tailwind CSS
Terminal	xterm.js
Desktop	Tauri 2
Build	Cargo workspace, Vite

Development

# Terminal 1: Start the Rust backend
cargo run -p rtb-cli

# Terminal 2: Start the frontend dev server
cd web && npm run dev

make help    # Show all available targets
make test    # Run all tests
make clean   # Remove build artifacts

Project Structure

remote-desktop-control/
+-- crates/
|   +-- core/           # Core library: event bus, PTY, sessions, agents, notifications, task pool
|   +-- server/         # Axum HTTP/WS server, REST API, static file embedding
|   +-- plugin-host/    # Plugin manager, IM and tunnel plugin interfaces
|   +-- cli/            # CLI entry point (clap), daemon lifecycle
+-- web/
|   +-- src/
|   |   +-- components/ # React components (Terminal, SessionList, AgentChat, etc.)
|   |   +-- hooks/      # Custom hooks (useTerminal, useWebSocket, useTheme, etc.)
|   |   +-- lib/        # API client, WebSocket helpers, types
|   +-- index.html
|   +-- tailwind.config.js
|   +-- vite.config.ts
+-- docs/               # Design specs and implementation plans
+-- .github/            # CI/CD workflows
+-- Cargo.toml          # Workspace root
+-- Makefile            # Build commands
+-- LICENSE             # MIT

License

MIT