Coven
一个本地优先的运行时底座,让 Codex、Claude Code、GitHub Copilot CLI 等编码智能体在同一项目边界内可被启动、观察和协调。
- Star 数
- ★ 76
- 最近更新
- 今天
- License
- MIT
- 主语言
- Rust
- FA 评分
- 66/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeChatGPT(部分支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者在同一仓库中切换 Codex、Claude Code 或 GitHub Copilot CLI,希望会话历史、事件日志和状态都保存在本地并由统一守护进程管理。
- 不适合
- 需要完全成熟、稳定 1.0 版本的生产团队(项目为早期 MVP,README 明示会有粗糙之处)
- 在含敏感密钥仓库中运行不可信提示词的用户(会话日志可能记录密钥)
- Alpine Linux 等非 glibc 环境的用户
- 官网
- opencoven.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.5.0(2026-11-10)
- 源码审查
- 66/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Coven 是 OpenCoven 生态的本地 harness 底座,为 Codex、Claude Code、GitHub Copilot CLI 等编码智能体 CLI 提供共享的项目级运行环境。它以 Rust 守护进程(daemon)作为权威边界:会话启动、工作目录校验、PTY 执行、事件日志与 SQLite 持久化都由守护进程完成,CLI、TUI 及其他客户端只是便利层,安全决策只向内汇聚到守护进程。项目采用本地优先架构,状态保存在本机(SQLite),并通过同机本地 IPC API(coven.daemon.v1 契约)对外提供接口。安装通过 npm 包 @opencoven/cli 分发,支持 macOS、Linux x64(glibc)和 Windows x64。项目为 MIT 许可的早期 MVP,处于活跃开发中,官方文档位于 docs.opencoven.ai。
Coven 的核心操作围绕项目级智能体会话展开:先运行 coven setup codex 完成厂商自有登录,再用 coven doctor 检查本地就绪状态;coven daemon start 启动 Rust 守护进程,负责 cwd 校验、PTY 生命周期、事件日志记录和 SQLite 持久化。coven run codex "fix the failing tests" 在项目边界内启动一次 Codex 会话;coven sessions 用于浏览和管理历史会话;coven daemon stop 停止守护进程。它支持的 harness 包括 Codex、Claude Code 和 GitHub Copilot CLI,并预留适配器契约(docs/HARNESS-ADAPTERS.md)供未来扩展。所有客户端(CLI/TUI、CastCodes、comux 或自建集成)通过同机本地 IPC API(coven.daemon.v1)访问同一会话状态。可选的内存仪表盘以 @opencoven/coven-memory-dashboard 单独安装。裸运行 coven 会打开交互式 UI。
- 开发者在同一仓库中切换 Codex、Claude Code 或 GitHub Copilot CLI,希望会话历史、事件日志和状态都保存在本地并由统一守护进程管理。
- 团队需要审计智能体在项目内做过什么:Coven 记录 PTY 执行与事件,并通过 coven sessions 浏览。
- 工具作者想在自己的界面或集成中呈现智能体工作,可基于同机 IPC API(coven.daemon.v1 契约)接入,而不重复实现执行层。
- 关注安全边界的用户希望由 Rust 守护进程(而非客户端)集中裁决 cwd 校验、PTY 生命周期与 IPC 访问。
- 多 harness 适配器作者可以按 docs/HARNESS-ADAPTERS.md 的契约实现并接入新的编码智能体 CLI。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @opencoven/clinpm install -g @opencoven/coven-memory-dashboard
- 配置文件
.env- 运行环境
- Node.js 24+
- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
通过 npm 安装 CLI(通用包装器会自动选择平台包),然后运行自检:
bash
npm install -g @opencoven/cli
coven doctor平台专用包:@opencoven/cli-macos(Apple Silicon)、@opencoven/cli-macos-x64(Intel)、@opencoven/cli-linux-x64(glibc x64,不支持 Alpine)、@opencoven/cli-windows(Windows x64)。可选的内存仪表盘需 Node.js 24+ 并单独安装:
bash
npm install -g @opencoven/coven-memory-dashboardnpm、cargo 与源码安装路线详见 https://docs.opencoven.ai/docs/guide/install。各 harness 的登录由对应厂商完成(如 Codex 用 coven setup codex)。
如何使用这个 Agent?
在目标项目目录中完成一次完整流程:
bash
cd /path/to/your/project
coven setup codex
coven doctor
coven daemon start
coven run codex "fix the failing tests"
coven sessions
coven daemon stop裸运行 coven 会打开交互式 UI。CLI 命令参考见 https://docs.opencoven.ai/docs/cli。贡献者注意事项:每次 PR 前运行 python scripts/check-secrets.py,不要提交运行时状态(.coven/、*.sqlite*、*.sock、.env*、*.key)。
这个 Agent 有哪些优点和局限?
- 多 harness 中立底座:同一项目边界内支持 Codex、Claude Code、GitHub Copilot CLI,避免绑定单一厂商的智能体。
- Rust 守护进程是唯一权威边界,安全决策(cwd 校验、PTY、IPC)不依赖客户端,架构上明确分层。
- 本地优先:会话状态持久化到本机 SQLite,事件日志可审计,并有 API 契约(coven.daemon.v1)供第三方集成。
- MIT 许可,外部 PR 开放,跨 macOS/Linux/Windows x64 分发。
- 早期 MVP,README 明示可用但会有粗糙之处,适合探险型开发者而非保守生产环境。
- 会话日志会捕获 harness 输出,若 harness 输出密钥则会被记录——官方建议不要在敏感仓库运行不可信提示词。
- Linux 分发仅支持 glibc x64,不支持 Alpine;内存仪表盘还需要 Node.js 24+ 并单独安装。
- 在适配器契约稳定前,harness 支持被有意限制在 Codex、Claude Code 和 GitHub Copilot CLI 三家。
这个 Agent 与同类方案有什么区别?
Coven 明确定位为 Codex、Claude Code、GitHub Copilot CLI 等编码智能体 CLI 之上的共享运行底座:这些工具本身各自拥有会话与权限模型,而 Coven 提供统一的会话生命周期、SQLite 持久化与权威守护进程,使任一 harness 的工作在同一项目内可见、可协调。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Coven 当前 | 66 · 存在缺口 | 命令行工具免费 | ★ 76 | 今天 | Rust | Codex · Claude Code |
| Yardlet | 80 · 表现良好 | 桌面应用免费 | ★ 46 | 今天 | Swift | Codex · Claude Code |
| OpenAgentd | 53 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 217 | 1 天前 | TypeScript | ChatGPT · OpenAI API · Claude API |
| Puppetmaster | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 479 | 今天 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
材料显示守护进程负责权限边界,同用户本地 IPC、受限 harness 清单、路径与 argv 校验、事件脱敏以及默认关闭原始敏感工件持久化;安装指南还说明凭据由各 harness 自行管理,变更型 HTTP 请求须先确认。扣分原因是安全策略明确指出 COVEN_HOME 权限加固仍有缺口,原始工件密钥也不是系统钥匙串管理;CI 可见依赖固定和检查,但没有足够材料证明全面的依赖漏洞治理。回滚与来源归属说明有限,仓库安全报告路径和维护者信息则有明确记载。
README、CLI 帮助、安装指南和安全策略对本地运行、项目范围及 harness 边界基本一致,安全策略还列出失败关闭、请求校验和验证族。缺少的运行验证不计分;依赖可用性只部分说明了平台、安装包和外部 harness 先决条件,未覆盖所有失败情形。doctor 的诊断及安装提示、权限故障排查提供了有用错误恢复线索,但所给样本不足以证明完整故障处理覆盖。
材料面向开发者,覆盖多 harness、CLI、daemon、IPC 客户端和多平台,并清楚说明支持、实验、未支持及远程访问边界。扣分原因是 skills 样本的触发描述不一致:仓库产品主线清晰,但其中清理技能范围很宽,且与主运行时用途关联较弱,触发精度因此有限。
仓库提供清晰的 README 导航、规范性架构与 API 文档索引、安装和卸载入口、详细 harness 安装步骤、示例及排障表;MIT 许可文本完整。安全策略明确标注预 1.0 状态、支持面、实验面和限制。扣分原因是样本未提供完整变更日志或清晰发布节奏证据;维护责任有安全报告渠道、贡献指南和作者,但支持承诺仅覆盖当前次版本线且无长期支持。
产品把不同编码 harness 纳入项目级会话、守护进程授权边界和持久化事件账本,CLI 流程及机器可读接口面向实际协作场景。扣分原因是材料没有量化节省或完整成本数据;用户仍需安装、认证并维护外部 harness,项目也自述处于早期 MVP。
关键安全主张关联到具体规范文档、实现边界和验证族,CI 工作流列出了守护脚本及测试命令;文档也将已执行属性、残余风险和设计目标分开。交叉佐证较好但并非所有证据都在所给样本中,且静态审查无法确认这些验证实际通过。
- 这是预 1.0 的早期软件;安全策略明确表示同用户运行的 harness 不受 Coven 沙箱隔离,勿在敏感仓库中运行不可信提示或 harness。
- 会话日志可能记录 harness 输出;不要在提示中粘贴秘密。启用原始工件持久化会保存未脱敏数据,尽管其默认关闭且会加密。
- 安全策略指出 COVEN_HOME 所有权和权限检查仍需加固;不要把本地 IPC 暴露到网络。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.5.0 Coven v0.5.0
发布说明摘录
Coven v0.5.0 This release advances Coven's supported release family to 0.5.x, fixes mobile signed-request replay retention, and pins Coven Code 0.9.0. Source manifests continue to use release-time version stamping. Changes since v0.4.10: - Retains mobile signed-request nonces through their complete accepted signature-validity window, including clock skew and the inclusive expiry boundary, and keeps retired requests expired after an in-process clock rollback. …在 GitHub 查看 ↗ -
v0.4.10 Coven v0.4.10
发布说明摘录
Coven v0.4.10 A fresh install can now create its first familiar without Cave, and Copilot replies reach the stream on Windows. ```sh npm install -g @opencoven/[email protected] coven doctor ``` CLI - coven familiar create <display name> (also coven familiars create) adds one familiar to familiars.toml and seeds <COVEN_HOME>/workspaces/familiars/<id>/ with starter SOUL.md and IDENTITY.md. --id, --emoji, --role and --description are optional. - The roster is written under an exclusive lock and staged beside the …在 GitHub 查看 ↗ -
v0.4.9 Coven v0.4.9
发布说明摘录
Coven v0.4.9 Coven implements every Automations v1 command: all 19 in the command matrix, including run-now, cancellation, retry and recovery. The daemon also keeps one long-lived main session per scope, and the CLI gains coven familiar-ledger and coven eval-loop. ```sh npm install -g @opencoven/[email protected] coven doctor ``` Automations - Five commands that v0.4.8 refused, or handled only through a compatibility path, are implemented. All five are owner-only. - occurrence.runNow.v1 starts one occurrence now. Replaying a request …在 GitHub 查看 ↗
常见问题
需要付费吗?
我的代码和会话数据存在哪里?
可以更换底层模型或 harness 吗?
安全性如何?可以运行不可信的提示词吗?
有哪些平台支持?
Coven 官网是什么?
Coven 开源吗?
Coven 还在维护吗?
Coven 是谁开发的?
谢谢反馈,我们会据此改进页面。