Coven

一个本地优先的运行时底座,让 Codex、Claude Code、GitHub Copilot CLI 等编码智能体在同一项目边界内可被启动、观察和协调。

Star 数
★ 76
最近更新
今天
License
MIT
主语言
Rust

30 秒速览

运行形态
命令行工具自托管服务代码库 / SDK
可在哪里用
通用 · 跨平台Codex · Claude CodeChatGPT(部分支持)
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
npm 包 @opencoven/cli(基于 Rust)Node.js 24+(仅内存仪表盘需要)macOS / Linux glibc x64 / Windows x64Shell / 命令行网络访问本地文件系统
典型场景
开发者在同一仓库中切换 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)

这个 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。

  1. 开发者在同一仓库中切换 Codex、Claude Code 或 GitHub Copilot CLI,希望会话历史、事件日志和状态都保存在本地并由统一守护进程管理。
  2. 团队需要审计智能体在项目内做过什么:Coven 记录 PTY 执行与事件,并通过 coven sessions 浏览。
  3. 工具作者想在自己的界面或集成中呈现智能体工作,可基于同机 IPC API(coven.daemon.v1 契约)接入,而不重复实现执行层。
  4. 关注安全边界的用户希望由 Rust 守护进程(而非客户端)集中裁决 cwd 校验、PTY 生命周期与 IPC 访问。
  5. 多 harness 适配器作者可以按 docs/HARNESS-ADAPTERS.md 的契约实现并接入新的编码智能体 CLI。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @opencoven/cli
  • npm 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-dashboard

npm、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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
66/ 100 五分制 3.3 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 1 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 17/29
可靠稳定 8/14
适用触发 12/18
规范维护 15/18
有效结果 7/13
证据核验 7/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

材料显示守护进程负责权限边界,同用户本地 IPC、受限 harness 清单、路径与 argv 校验、事件脱敏以及默认关闭原始敏感工件持久化;安装指南还说明凭据由各 harness 自行管理,变更型 HTTP 请求须先确认。扣分原因是安全策略明确指出 COVEN_HOME 权限加固仍有缺口,原始工件密钥也不是系统钥匙串管理;CI 可见依赖固定和检查,但没有足够材料证明全面的依赖漏洞治理。回滚与来源归属说明有限,仓库安全报告路径和维护者信息则有明确记载。

可靠稳定8 / 14 · 2.9/5

README、CLI 帮助、安装指南和安全策略对本地运行、项目范围及 harness 边界基本一致,安全策略还列出失败关闭、请求校验和验证族。缺少的运行验证不计分;依赖可用性只部分说明了平台、安装包和外部 harness 先决条件,未覆盖所有失败情形。doctor 的诊断及安装提示、权限故障排查提供了有用错误恢复线索,但所给样本不足以证明完整故障处理覆盖。

适用触发12 / 18 · 3.3/5

材料面向开发者,覆盖多 harness、CLI、daemon、IPC 客户端和多平台,并清楚说明支持、实验、未支持及远程访问边界。扣分原因是 skills 样本的触发描述不一致:仓库产品主线清晰,但其中清理技能范围很宽,且与主运行时用途关联较弱,触发精度因此有限。

规范维护15 / 18 · 4.2/5

仓库提供清晰的 README 导航、规范性架构与 API 文档索引、安装和卸载入口、详细 harness 安装步骤、示例及排障表;MIT 许可文本完整。安全策略明确标注预 1.0 状态、支持面、实验面和限制。扣分原因是样本未提供完整变更日志或清晰发布节奏证据;维护责任有安全报告渠道、贡献指南和作者,但支持承诺仅覆盖当前次版本线且无长期支持。

有效结果7 / 13 · 2.7/5

产品把不同编码 harness 纳入项目级会话、守护进程授权边界和持久化事件账本,CLI 流程及机器可读接口面向实际协作场景。扣分原因是材料没有量化节省或完整成本数据;用户仍需安装、认证并维护外部 harness,项目也自述处于早期 MVP。

证据核验7 / 8 · 4.4/5

关键安全主张关联到具体规范文档、实现边界和验证族,CI 工作流列出了守护脚本及测试命令;文档也将已执行属性、残余风险和设计目标分开。交叉佐证较好但并非所有证据都在所给样本中,且静态审查无法确认这些验证实际通过。

风险与缓解建议
  • 这是预 1.0 的早期软件;安全策略明确表示同用户运行的 harness 不受 Coven 沙箱隔离,勿在敏感仓库中运行不可信提示或 harness。
  • 会话日志可能记录 harness 输出;不要在提示中粘贴秘密。启用原始工件持久化会保存未脱敏数据,尽管其默认关闭且会加密。
  • 安全策略指出 COVEN_HOME 所有权和权限检查仍需加固;不要把本地 IPC 暴露到网络。
证据充分度:低 评估于 2026年11月8日 审查版本 cd49b0ec0910 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/coven.svg?lang=zh)](https://followagents.com/zh/agents/coven)
<a href="https://followagents.com/zh/agents/coven"><img src="https://followagents.com/badge/coven.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 查看 ↗

常见问题

需要付费吗?
Coven 本身是 MIT 许可的免费开源软件。运行各 harness 所需的账号与订阅由对应厂商(OpenAI、Anthropic、GitHub)另行决定,Coven 不代收费用。
我的代码和会话数据存在哪里?
本地优先:会话状态持久化到本机 SQLite(通过守护进程),运行时状态位于 .coven/ 目录,不应提交到版本库。
可以更换底层模型或 harness 吗?
可以。Coven 是 model-agnostic 的 harness 底座,当前支持 Codex、Claude Code 和 GitHub Copilot CLI,未来适配器按 docs/HARNESS-ADAPTERS.md 契约接入;登录使用各厂商自有流程。
安全性如何?可以运行不可信的提示词吗?
官方明确建议不要在敏感仓库中运行不可信 harness 或提示词:会话日志会捕获 harness 输出,若输出中含密钥会被记录。事件载荷在 API 展示前会做脱敏,但纵深防御始于不把密钥放进提示词。漏洞请通过 GitHub Security Advisories 报告。
有哪些平台支持?
macOS(Apple Silicon 与 Intel x64)、glibc Linux x64(不支持 Alpine)、Windows x64。内存仪表盘额外要求 Node.js 24+。
Coven 官网是什么?
Coven 的 GitHub 仓库填写的官网是 https://opencoven.ai。这个链接由仓库作者设置;源码在 GitHub(OpenCoven/coven)。
Coven 开源吗?
开源。源码在 GitHub(OpenCoven/coven),许可证是 MIT。
Coven 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v0.5.0(2026-11-10)。
Coven 是谁开发的?
Coven 由 GitHub 账号 OpenCoven 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念