CLI Agent(Linux)

从终端运行 agent — 仅在 Linux 和无界面服务器上推荐使用。

何时使用 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               显示帮助