Grok Build Web UI
Capricorn · AgentsHarness 的第一颗星座
AgentsHarness 让你随时随地远程使用 Agents。
Capri(Capricorn)是 Grok Build 的具体适配项目,我们基于 ACP 协议,搭配 capri-host、capri-hub 实现远程数据传输。
快速开始: 安装 Grok Build 启动 capri-host 后会自动拉起 Grok Build 核心以及开放
http://localhost:8765,WebUI 已经自动嵌入。
- 在手机、平板、另一台电脑的浏览器里,继续本机 grok 的会话
- 左上角切换 Host:家里的、办公室的、服务器上的
- 斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆——对齐 Grok Build TUI 的常用能力
Agent 在 Host 那台机器上自己读文件、跑命令。浏览器只负责掌控。
需要本机已有 capri-host(或 capri-hub)。
# 终端 1 — 本机节点
cd ../capri-host && go run ./cmd/capri-host
# 终端 2 — 前端
pnpm install
pnpm run dev打开 http://localhost:5173。开发服务器会把 /api、/events 代理到 http://localhost:8765。
连上 Hub、同时看好几台机器:
VITE_PROXY_TARGET=http://<hub>:8787 pnpm run dev若 Hub 设置了 FE_TOKEN,页面会弹出密钥框。密钥只存在你这台浏览器里,不要写进 VITE_* 或打进静态包。
打开页面只问 Hub 那把。之后如果发现选中的一台 Host 就跑在这台电脑上,页面会默认 直连它的本地端口(少一跳中继,Hub 不可达时也还能用),而不是绕 Hub。
- 那台 Host 没设
FE_TOKEN:直连是免鉴权的本机请求,什么都不问。 - 设了:页面先拿 Hub 那把探一次它的
GET /api/probe。两把同值就直接连通,不多问; 不同值才弹一次「这台 Host 的钥匙」(按机器分别保存,不会覆盖 Hub 那把)。 - 不想输可以拒填:那一台退回 Hub 中继,Hub 登录不受影响。事后也能在左上角 Host 列表的右键菜单里改:「直连本机」/「经 Hub 中继」,行上会标当前是直连还是中继。
Hub 那把失效(服务端换了 FE_TOKEN)才会把页面送回门禁。
| 变量 | 说明 |
|---|---|
VITE_PROXY_TARGET |
开发代理目标。默认本机 Host http://localhost:8765 |
| 项目 | 介绍 |
|---|---|
| AgentsHarness | 总项目 |
| capri-host | Agent 节点,内嵌 Capri FE |
| capri-hub | 中继节点,转发用户和 Agent 消息 |
MIT · Linux.do

