Control your AI coding terminal from anywhere
随时随地控制你的 AI 编程终端
Features • Installation • Usage • Development
VibeLink is a mobile app that lets you remotely control AI coding assistants (like Claude Code, OpenCode) running on your computer. Perfect for:
- 📱 Monitoring long-running AI coding tasks from your phone
- 🔔 Getting notifications when tasks complete
- ⌨️ Sending commands to your terminal remotely
- 🌙 Supporting both light and dark themes
| Feature | Description |
|---|---|
| Remote Terminal | Full terminal emulation with ANSI color support |
| Quick Start | One-tap launch for Bash, Claude Code, or OpenCode |
| Session Management | List, switch, and close terminal sessions |
| Special Keys | Ctrl+C, Tab, arrow keys, and more |
| Theme Support | Light and dark mode with persistent settings |
| Notifications | Get notified when tasks complete (idle detection) |
┌─────────────────┐ ┌─────────────────┐
│ VibeLink App │◄───────►│ Python Server │
│ (Flutter) │ HTTP/ │ (FastAPI) │
│ │ WebSocket │
└─────────────────┘ └────────┬────────┘
│
▼
┌─────────────────┐
│ PTY Terminal │
│ (Claude Code, │
│ OpenCode, │
│ Bash, etc.) │
└─────────────────┘
# Clone the repository
git clone https://github.com/catDforD/VibeLink.git
cd VibeLink/server
# Install dependencies
pip install -r requirements.txt
# Start the server
python server.pyThe server will start on http://0.0.0.0:8000
Download the APK from your server:
http://<your-server-ip>:8000/download/app
Or build from source (see Development section).
- Start the server on your computer
- Connect the app using your server's IP address (e.g.,
192.168.1.100:8000) - Start a session by selecting a tool (Bash/Claude Code/OpenCode) and working directory
- Control your terminal using the input bar and special key buttons
- Local Network: Use your computer's local IP (e.g.,
192.168.1.100:8000) - Remote Access: Use Tailscale for secure access from anywhere
VibeLink 是一款移动应用，让你可以远程控制运行在电脑上的 AI 编程助手（如 Claude Code、OpenCode）。适用于：
- 📱 用手机监控长时间运行的 AI 编程任务
- 🔔 任务完成时收到通知
- ⌨️ 远程向终端发送命令
- 🌙 支持亮色和暗色主题
| 功能 | 说明 |
|---|---|
| 远程终端 | 完整的终端模拟，支持 ANSI 颜色 |
| 快速启动 | 一键启动 Bash、Claude Code 或 OpenCode |
| 会话管理 | 列出、切换和关闭终端会话 |
| 特殊按键 | Ctrl+C、Tab、方向键等 |
| 主题支持 | 亮色和暗色模式，设置自动保存 |
| 通知提醒 | 任务完成时收到通知（空闲检测） |
# 克隆仓库
git clone https://github.com/catDforD/VibeLink.git
cd VibeLink/server
# 安装依赖
pip install -r requirements.txt
# 启动服务
python server.py服务将在 http://0.0.0.0:8000 启动
从服务器下载 APK：
http://<你的服务器IP>:8000/download/app
或从源码构建（见开发部分）。
- 在电脑上启动服务
- 使用服务器 IP 地址连接应用（如
192.168.1.100:8000） - 选择工具（Bash/Claude Code/OpenCode）和工作目录启动会话
- 使用输入栏和特殊按键控制终端
- 局域网访问：使用电脑的局域网 IP（如
192.168.1.100:8000） - 外网访问：使用 Tailscale 实现安全的远程访问
- Flutter SDK 3.x
- Android SDK
- Python 3.8+
cd app
# Get dependencies
flutter pub get
# Build debug APK
flutter build apk --debug
# Build release APK
flutter build apk --releaseVibeLink/
├── app/ # Flutter mobile app
│ ├── lib/
│ │ ├── main.dart
│ │ ├── models/
│ │ ├── screens/
│ │ └── services/
│ └── android/
├── server/ # Python backend
│ ├── server.py # FastAPI server
│ ├── terminal.py # PTY management
│ ├── notifier.py # Push notifications
│ └── static/ # Web terminal
└── README.md
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/health |
Health check |
| POST | /api/sessions |
Create session |
| GET | /api/sessions |
List sessions |
| DELETE | /api/sessions/{id} |
Close session |
| POST | /api/quick-start |
Quick start tool |
| WS | /ws/{session_id} |
Terminal WebSocket |
| GET | /download/app |
Download APK |
MIT License
Contributions are welcome! Please feel free to submit a Pull Request.
Made with ❤️ for the Vibe Coding community