何时使用 CLI
CLI agent 从终端运行 Btelo Coding。适合以下情况:
- 你在使用 Linux — Linux 没有桌面应用。
- 你在没有桌面环境的无界面服务器或 VPS 上运行。
- 你想通过脚本或自动化方式启动 agent。
在 Mac 和 Windows 上,桌面应用是运行 agent 的推荐方式 — 一次下载,引导式设置,无需终端。只有当你明确需要终端工作流时,才在这两个平台上使用 CLI。
安装
Linux / macOS:
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows(PowerShell):
irm https://coding.btelo.com/install.ps1 | iex
启动 Agent
vibe-remote
TUI 界面会出现。按 c 设置连接器名称和密码。Agent 会自动连接到云端 relay,并在 Dashboard 上显示一个配对二维码。从 iOS app 扫描即可连接。
TUI 快捷键(Dashboard 标签页):
| 按键 | 操作 |
|---|---|
| c | 配置 — 设置连接器名称和密码 |
| w | 切换 relay 服务器 |
| d | 管理已连接设备 |
| r | 刷新二维码 |
| h | 显示 / 隐藏二维码 |
| m | 切换二维码角色(管理员 / 成员) |
| y | 复制二维码链接到剪贴板 |
| t | 桌面帮助 |
| i | 安装二维码(App Store 链接) |
| u | 更新后重启 |
| s | 停止服务 |
| q | 退出 TUI |
| 1/2/3 | 切换标签页(Dashboard / Logs / Install) |
Logs 标签页: g 跳到顶部,G 跳到底部,x 清空日志。
Devices 弹窗: k 踢出所选设备,r 刷新列表。
Headless 模式
Windows 上不支持交互式 TUI,无界面服务器上也不需要它。请使用无 TUI 方式启动:
vibe-remote --headless --connector myconnector --password mypassword
更新
vibe-remote update
更新下载完成后,在 TUI 中按 u 即可在新版本上重启,并保持连接不中断。
CLI 参考
vibe-remote 启动 TUI(默认)
vibe-remote --headless 无 TUI 启动
vibe-remote client 连接到远程 agent(反向模式)
vibe-remote relay 作为 relay 服务器运行
vibe-remote delete-connector 删除已保存的连接器
vibe-remote update 更新到最新版本
vibe-remote version 显示版本
vibe-remote help 显示帮助