跳到正文

基于 ACP 协议 · MIT 开源

Agents Harness 随时随地，接管智能体

Agent 留在各自设备上读文件、改代码、跑测试；手机、平板或另一台电脑打开浏览器，即可跨屏接管会话。

现已适配 Grok Build；macOS、Windows 开箱即用。

下载 macOS 版
桌面端 · 浏览器
Grok Night 主题下的 Capri 桌面端界面实拍
移动端 · 手机
Grok Night 主题下的 Capri 移动端界面实拍

架构与三端分工

单机一个进程起步，多机加一台中继

切换下方拓扑模式，查看请求如何从浏览器抵达本机内核，以及三个组件各自的职责边界。

capri-host 二进制已内嵌完整前端界面。打开 Capri.app 或 Capri.exe 后，浏览器访问 http://localhost:8765 即可直接使用，无需部署 capri-hub。

浏览器控制台

Capri FE

capri-fe · React 19 · TypeScript · Vite · Tailwind

发送指令、流式渲染、审批权限；门禁密钥仅存浏览器本地。

  • 斜杠命令（/model、/theme、/memory、/rewind）、! Shell 直连与草稿暂存
  • 行内权限审批卡、问题询问卡与 MCP Elicit 表单交互
  • Git 状态/分支/Worktree 面板、子代理全屏检视与上下文用量分布

任意设备浏览器

Agent 节点

Capri Host

capri-host · Go 1.26 · SwiftUI (macOS) · Systray (Windows) · ACP

内嵌前端界面与 API，守护内核进程，提供 macOS / Windows 原生托盘。

  • macOS 菜单栏（Capri.app）与 Windows 托盘（Capri.exe）图形化启停、防休眠与开机自启
  • Linux 与服务器可直接运行单文件二进制，零外部静态资源依赖
  • 服务端规整 ACP 事件契约，自动裁剪回滚死分支并按需补全历史输出

HTTP :8765

Agent 内核

grok

在节点本机读写代码库、执行终端命令、调度子代理与 MCP 工具。

stdio JSON-RPC (ACP)

HTTP / SSE 127.0.0.1:8765

工程机制

把长会话、跨网与安全做扎实的六件事

01θ Cap

按需续传，秒开长会话

打开已有会话只拉取最新一轮并立即进入可交互态；上滑翻页按轮加载，大体积工具输出后台静默补全，不在首屏重放全量历史。

02ι Cap

同机自动走本地近路

即使从公网 Hub 打开控制台，只要探测到当前选中的节点就跑在本机，API 与事件流自动直连 127.0.0.1:8765，省去一跳中继延迟。

03ζ Cap

QUIC 优先，受阻无感回退

节点到中继默认使用 QUIC（UDP :8788）长连接；遇到安全组或代理拦截 UDP 时自动回退到 WebSocket，无需人工干预。

04δ Cap

双钥分离，门禁归浏览器

Hub 与每台 Host 的 FE_TOKEN 彼此独立、分槽保存在浏览器本地。Host 默认只听回环地址（127.0.0.1），留空即可本机免密直连。

05γ Cap

一次 6 位码，重启免再配

配对码每 15 分钟自动轮换。在桌面设置界面或前端填入一次后，长期凭据写入本机 ~/.capri-host/hub.json，后续重启自动重连。

06ω Cap

无人订阅时自动静默

中继模式下没有任何浏览器打开页面时，节点自动暂停实时状态上报以节省带宽与算力；页面打开瞬间即刻恢复。

快速上手

按你的平台，五分钟跑起来

前往 GitHub Releases 下载
macOS 菜单栏应用（Capri.app） 推荐 · macOS 13+ 
# 1. 从 Releases 下载 Capri-macos.zip 或 Capri-macos.dmg，将 Capri.app 拖入「应用程序」
# 2. 若首次启动提示无法验证开发者，执行以下命令移除隔离属性后打开：
xattr -dr com.apple.quarantine /Applications/Capri.app
open -a /Applications/Capri.app
点击屏幕右上角摩羯座图标 →「设置…」（⌘,）→「保存并启动」→「打开界面」即可访问 http://localhost:8765。
Windows 托盘应用（Capri.exe） 推荐 · 系统托盘 
# 下载 Capri-windows-amd64.zip（或 arm64），完整解压后双击根目录的 Capri.exe：
Capri/
├── Capri.exe            # ← 双击它：托盘图标、图形设置页、进程守护
└── bin/
    └── Capri-host.exe   # 后台引擎（由 Capri.exe 无窗口拉起并接管日志，请勿单独双击）
右键任务栏托盘摩羯图标 →「设置…」保存配置 → 点击「打开 Capri 控制台」进入 Web 界面。
Linux 服务器与命令行运行 单文件二进制 
chmod +x ./Capri-host
./Capri-host
# 浏览器直接访问 http://localhost:8765
# 从源码构建运行（需 Go 1.26+）：go run ./cmd/capri-host
单文件已内嵌前端构建产物，适合无桌面环境的 Linux 服务器、脚本或 systemd 托管。
部署 capri-hub 并配对多台节点 多机 / 外网可选 
# 1. 公网服务器启动 Hub（也可用 Docker Compose）：
FE_TOKEN=$(openssl rand -hex 24) ./capri-hub
./capri-hub paircode          # 获取当前 6 位配对码（15 分钟自动轮换）

# 2. 节点接入（桌面端在「设置 → Hub」填入；命令行如下）：
HUB_URL=https://your-hub HUB_PAIR_CODE=123456 HOST_ID=work-pc ./Capri-host
配对成功后长期凭据写入 ~/.capri-host/hub.json，后续重启只需保留 HUB_URL。