跳到正文
CapriCapricorn

基于 ACP 协议的远程 Agent 控制台

 Agent

手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。Agent 仍然在你自己的机器上读文件、跑命令;浏览器只负责掌控。

一个进程、一个端口,同时提供 Web 界面和接口。

三个组件

三个组件

只在一台机器上用?不必起中继,直接跑节点即可。

浏览器控制台

5173

开发服务器;生产由 Host 内嵌托管

Capri FE

React 19 · TypeScript · Vite · Tailwind

对齐终端界面常用能力的 Web 前端:斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆。左上角随手切换机器。

  • 会话续传,不重放全量历史
  • 权限审批与作用域记忆
  • 图片、后台任务、子代理视图
  • 密钥只存在这台浏览器里

Agent 节点

8765

界面 + 接口同端口

Capri Host

Go 1.26 · ACP · stdio JSON-RPC

跑在有 Agent 的那台机器上,自动拉起内核,并把 Web 界面一起端出来。不用 nginx,不用另起静态服务器。

  • 单进程内嵌前端构建产物
  • 本机直连或中继两种模式
  • 无人订阅时暂停上报省流量
  • 配对 token 落盘,重启免配对

中继节点

8787

HTTP;节点主通道 UDP 8788

Capri Hub

Go 1.26 · QUIC · WebSocket

汇集你所有的节点:家里的、办公室的、服务器上的。它不执行任何命令,只做配对、发现和转发。

  • QUIC 主通道,挡了自动回退
  • 六位配对码,十五分钟有效
  • 浏览器门禁与 CORS 收口
  • 只在一台机器上用时不必部署
能力

能做的事

01 换个屏幕,接着说

在手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。恢复会话不重放全量历史,打开就能接上。

02 多台机器,一个入口

左上角切换节点:家里的、办公室的、服务器上的。每台机器一个标识,中继负责找到它。

03 该有的都有

斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆——对齐终端界面的常用能力。

04 代码不出你的机器

Agent 在节点那台机器上自己读文件、跑命令。浏览器只发指令、看结果。中继不执行任何命令。

05 一个进程,一个端口

节点二进制里嵌着前端构建产物,打开根路径就是界面,同端口提供接口。不用 nginx。

06 先 QUIC,挡了就退

节点到中继默认走 QUIC;UDP 被挡时自动回退 WebSocket,功能不受影响。域名经代理丢 UDP 时可强制拨号地址。

07 配一次,之后就忘了它

中继启动打印六位配对码,十五分钟有效。配对成功后 token 写在那台机器上,重启只需要中继地址。

08 没人看的时候安静

中继模式下没有浏览器订阅时,节点暂停实时上报以省流量;打开页面自动恢复。

架构

一次请求要走的路

浏览器 任何设备

只负责掌控:发指令、看结果、审批权限。门禁密钥存在本地,不进构建产物。

中继 HTTP 8787

配对、发现、转发三件事。不执行命令,不落业务数据。可选,单机场景省掉。

主通道 QUIC UDP 8788

节点与中继之间的长连接。UDP 被安全组挡住时自动回退 WebSocket。

节点 HTTP 8765

你的机器。拉起内核、内嵌界面、代理接口,同一个端口全都给了。

内核 stdio JSON-RPC

以标准输入输出跑的 Agent 进程,按 ACP 协议交换会话事件、工具调用与权限请求。

一个进程、一个端口,同时提供 Web 界面和接口。

0组件
0端口起步
0位配对码
0分钟有效
0命令在中继执行
快速开始

五分钟跑起来

本机:一条命令
chmod +x ./capri-host
./capri-host
# 浏览器打开 http://localhost:8765
从 Releases 下载对应平台的二进制即可。
从源码跑
go run ./cmd/capri-host
需要 Go 1.26 以上。
起中继
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
每台机器给一个不同的标识。