快速开始

安装 Beav CLI

通过官网安装脚本安装或更新 Beav CLI，并在本机浏览器中使用完整工作台。

Beav CLI 适合不需要桌面窗口、希望让 Beav 在后台持续运行，或要把 Beav 连接到 Codex、WorkBuddy 等 Agent 宿主的用户。它与桌面版使用同一套 UI、内部 Agent、工作空间和产品版本；区别只是通过 localhost 浏览器访问，不会在 Dock 或任务栏显示桌面窗口。

macOS 与 Linux

在终端运行：

curl -fsSL https://beav.ziz.hk/install-cli.sh | sh

安装器会识别操作系统和 CPU 架构，从 Beav 官网镜像下载对应版本，验证签名、SHA-256 和文件大小，然后安装到当前用户目录。安装成功后会运行 beav open，默认工作台地址只监听本机 127.0.0.1。

如果 ~/.local/bin 尚未加入 PATH，可以直接运行：

~/.local/bin/beav open

Linux 安装前还需要系统提供 curl、tar 和 minisign。macOS 会同时验证运行时的系统代码签名。

Windows

在 PowerShell 中运行：

irm https://beav.ziz.hk/install-cli.ps1 | iex

安装器会验证下载摘要、归档内容、Windows Authenticode 签名和 Beav 发布签名，再安装到当前用户的 %LOCALAPPDATA%\Beav。

启动与后台值守

beav open

beav open 会确保本机服务已经启动，并打开浏览器。服务启动后会继续在后台值守；关闭浏览器标签页不会停止 Beav，同一台电脑上的其他浏览器也可以访问终端显示的本机地址。

常用命令：

beav status
beav open
beav stop
beav doctor

CLI 本地模式不需要 Beav 管理员账号。打开工作台后，用户仍然需要登录自己的 Beav 账号。只有显式启用局域网或远程访问时，才需要额外的管理员鉴权和网络安全配置。

更新

再次执行同一条官网安装命令即可更新。安装器会下载当前完整版本，验证后切换到新版本；如果安装后的健康检查失败，Unix 安装器会恢复此前的可用版本。

也可以先下载安装器再明确执行更新动作：

curl -fsSL https://beav.ziz.hk/install-cli.sh -o /tmp/beav-install.sh
sh /tmp/beav-install.sh update

PowerShell 对应命令：

$installer = Join-Path $env:TEMP 'beav-install.ps1'
irm https://beav.ziz.hk/install-cli.ps1 -OutFile $installer
& $installer -Action update

卸载

macOS 与 Linux：

curl -fsSL https://beav.ziz.hk/install-cli.sh | sh -s -- uninstall

Windows PowerShell：

$installer = Join-Path $env:TEMP 'beav-install.ps1'
irm https://beav.ziz.hk/install-cli.ps1 -OutFile $installer
& $installer -Action uninstall

普通卸载会删除 CLI 程序，但保留产品数据。清除产品数据属于单独的高风险操作，不要把它与日常更新或重新安装混用。

连接 Codex 或 WorkBuddy

CLI 工作台正常启动后，再按照在 Agent 中使用 Beav安装 Beav Creator Plugin。宿主 Agent 通过 MCP 与 Beav 内部 Agent 通信；浏览器 UI 只供用户查看结果、审批和手动编辑。