Capri FE
浏览器控制台 :5173对齐终端界面常用能力的 Web 前端:斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆。左上角随手切换机器。
React 19 · TypeScript · Vite · Tailwind · 开发服务器;生产由 Host 内嵌托管
基于 ACP 协议的远程 Agent 控制台
手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。Agent 仍然在你自己的机器上读文件、跑命令;浏览器只负责掌控。
对齐终端界面常用能力的 Web 前端:斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆。左上角随手切换机器。
React 19 · TypeScript · Vite · Tailwind · 开发服务器;生产由 Host 内嵌托管
跑在有 Agent 的那台机器上,自动拉起内核,并把 Web 界面一起端出来。不用 nginx,不用另起静态服务器。
Go 1.26 · ACP · stdio JSON-RPC · 界面 + 接口同端口
汇集你所有的节点:家里的、办公室的、服务器上的。它不执行任何命令,只做配对、发现和转发。
Go 1.26 · QUIC · WebSocket · HTTP;节点主通道 UDP 8788
能力
这十个站点的文案与文档来自同一份内容源。改一次,十个站点一起变;下面这串指纹是内容的哈希,十个站点都印着同一个值。
01
在手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。恢复会话不重放全量历史,打开就能接上。
02
左上角切换节点:家里的、办公室的、服务器上的。每台机器一个标识,中继负责找到它。
03
斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆——对齐终端界面的常用能力。
04
Agent 在节点那台机器上自己读文件、跑命令。浏览器只发指令、看结果。中继不执行任何命令。
05
节点二进制里嵌着前端构建产物,打开根路径就是界面,同端口提供接口。不用 nginx。
06
节点到中继默认走 QUIC;UDP 被挡时自动回退 WebSocket,功能不受影响。域名经代理丢 UDP 时可强制拨号地址。
07
中继启动打印六位配对码,十五分钟有效。配对成功后 token 写在那台机器上,重启只需要中继地址。
08
中继模式下没有浏览器订阅时,节点暂停实时上报以省流量;打开页面自动恢复。
架构
只负责掌控:发指令、看结果、审批权限。门禁密钥存在本地,不进构建产物。
配对、发现、转发三件事。不执行命令,不落业务数据。可选,单机场景省掉。
节点与中继之间的长连接。UDP 被安全组挡住时自动回退 WebSocket。
你的机器。拉起内核、内嵌界面、代理接口,同一个端口全都给了。
以标准输入输出跑的 Agent 进程,按 ACP 协议交换会话事件、工具调用与权限请求。
只在一台机器上用?不必起中继,直接跑节点即可。
快速开始
chmod +x ./capri-host
./capri-host
# 浏览器打开 http://localhost:8765
go run ./cmd/capri-host
FE_TOKEN=$(openssl rand -hex 24) go run ./cmd/capri-hub
HUB_URL=http://your-relay:8787 \
HUB_PAIR_CODE=XXXXXX \
HOST_ID=macbook HOST_NAME="办公室 Mac" \
./capri-host
curl http://127.0.0.1:8787/api/pairing
curl -X POST http://127.0.0.1:8787/api/pairing/rotate
npm install
npm run dev
# 代理默认指向本机节点;换目标:
VITE_PROXY_TARGET=http://your-relay:8787 npm run dev