Atris 项目工作台
让编码代理共享项目记忆、执行有边界的任务,并用可运行的检查证明结果。
- Star 数
- ★ 71
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望 Claude Code、Codex 或 Cursor 在多个会话间共享仓库记忆的开发团队。
- 不适合
- 需要所有任务状态都只保存在本地的团队
- 需要在无 GitHub 自动合并流程的情况下自动落地成员改动的团队
- 官网
- atris.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v3.90.0(2026-11-20)
- 源码审查
- 47/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Atris 是运行在代码仓库上的 Node.js CLI 工作台,也提供 MCP 服务和可选的云工作区。初始化后,它把共享上下文保存在仓库文件中,包括代理说明、导航索引、任务、日志和 wiki 页面。代理可按 plan、do、review 流程工作,也可通过 run 或 autopilot 推进任务。任务能够绑定验证命令,工作结果可记录收据;成员工作还会经过独立引擎复核。云工作区、企业功能和集成需要额外设置,README 也描述了使用托管 Atris 云的 ax 聊天 CLI。
在项目目录执行 atris init 会生成 atris/ 工作区;atris 随后读取上下文并交由 atris/atris.md 中的流程处理。团队可用 atris task new 建立任务、指定 --verify 命令,再通过 next、ready --proof 和人工 accept 管理任务状态。atris wiki、atris ingest 和 atris loop 用于整理来源材料、维护链接页面并刷新 wiki 状态。需要自动推进时,可用 atris run 或 atris autopilot;成员工作可通过独立副本执行、验证和复核。Atris 将过程记录到日志、任务事件和收据中;企业云工作区使用 Supabase 任务状态,Sw arlo 负责实时认领层。
- 希望 Claude Code、Codex 或 Cursor 在多个会话间共享仓库记忆的开发团队。
- 需要为每项代理任务指定测试或其他确定性验证命令的维护者。
- 用多个编码代理并行处理安全范围内任务,并要求独立复核与分支交付的团队。
- 想把散乱的本地资料整理为带状态和链接的项目 wiki 的工程负责人。
- 需要在企业工作区中记录任务、运行历史并生成操作摘要的团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g atris
- 运行环境
- Node.js 18
如何安装或部署这个 Agent?
需要 Node.js 18 或更高版本;atris task 需要 Node.js 22 或更高版本。全局安装 CLI:
npm install -g atris
atris --version云工作区、企业功能或集成需要运行 atris setup。README 未列出 MCP 客户端的具体配置步骤或所需凭据。
如何使用这个 Agent?
在目标仓库初始化工作区,然后启动 Atris:
cd your-project
atris init
atris代理应读取 atris/atris.md 并按其说明操作。创建带验证命令的任务示例:
atris task new "fix the flaky login test" --verify "node --test test/login.test.js"完成工作后,任务可通过 atris task ready <id> --proof "..." 提交证明,再由人执行 atris task accept <id>。要以单个目标启动有界任务,可运行:
atris run "fix the flaky login test"这个 Agent 有哪些优点和局限?
- 项目记忆以普通仓库文件保存,可由多个代理和人员共享,并在 Git 中审阅。
- 任务可绑定可执行验证命令,成员工作还会由不同于构建者的引擎复核。
- 可切换已安装的编码 CLI 引擎,并按任务角色配置工作引擎。
- 支持本地 wiki、日志和任务工作流,也提供可选云同步与企业工作区。
atris task要求 Node.js 22;基础安装要求 Node.js 18 以上。- README 未说明 MCP 客户端配置流程,接入前需要确认具体连接方式。
- 自动落地成员改动依赖开启 self-landing,并由 GitHub 自动合并和 CI 完成合并。
- 企业云工作区中的任务状态使用 Supabase,实时认领层使用 Swarlo。
这个 Agent 与同类方案有什么区别?
README 将 Atris 的项目记忆与 Mem0、Zep 和 Letta 的聊天应用用户记忆作了对比:Atris 面向代码项目,以仓库文件保存共享记忆。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Atris 项目工作台 当前 | 47 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 71 | 1 天前 | JavaScript | Codex · Claude Code |
| no_human | 75 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 322 | 1 个月前 | Python | Claude Code |
| Citadel 编码代理运行层 | 84 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 935 | 16 天前 | JavaScript | Codex · Claude Code |
| mex 项目记忆 | 84 · 表现良好 | 命令行工具免费 | ★ 1.8k | 2 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示存在若干信任控制:MCP 的 campaign_ask/campaign_answer 明确要求不可逆操作(发送、付款、删除、部署、发布)先停下等人回答,且 agent 不能自行关闭 ask;tune 技能要求 diff 展示与显式批准;autoland 默认关闭,受保护区域(支付、部署、凭证)不自动落地。但扣分点同样明确:CLAUDE.md 在每次会话开始时强制执行 `atris atris.md` 并展示输出,属于无确认的自动行为;swarlo 技能直接 curl 本地 8090 端口并携带 Bearer KEY,且要求 `git pull && git push` 自动推送;README 中 `atris agent-client create` 可签发带 mcp:read、x-search 等 scope 的客户端密钥,权限范围与最小权限原则的对应关系未在包内说明;数据流方面,ax 默认走托管云、design 工具调用外部 API 并计费,但包内没有集中说明哪些数据离开本机;敏感数据处理仅见 `atris wiki --private` 存到 .atris/presidio/ 一句,缺少加密、保留期、日志脱敏说明;回滚方面有 `atris member tidy`、`atris land --reap`、`run prune-logs`,但没有针对已落地变更或已推送分支的统一回滚流程;来源归属方面有 MIT 与作者字段,但发布者身份未经验证,且大量外部链接(atris.ai 博客、托管 API)无法在包内核实。依赖安全方面 package.json 无运行时依赖、CI 用 npm ci 与只读权限,属于加分,但 prepare 脚本会写入 git hooks,属于安装期副作用,故未给满分。
可靠性证据:CI 分 8 片跑 node --test,并有 macOS 沙箱测试工作流;accept-verify-gate 的测试固定了失败文案(目录不存在 vs 命令未通过 vs 非可证伪命令),说明失败信息是被认真设计的。扣分点:README 与 package.json 对 Node 版本要求不一致(README 写 18+,task 需 22+,package.json engines 为 >=22.13),这是自相矛盾;README 极长且包含大量未在包内可验证的运行时行为描述(fleet 计分、landing 判定规则),静态无法确认其与代码一致;依赖可用性方面零运行时依赖是强项,但 ax 与 design 工具依赖托管云服务,离线不可用,且未说明降级路径。
受众与场景覆盖较好:README 面向个人、企业、AgentXP 玩家、业务运营等多种场景,AGENTS.md/CLAUDE.md/FOR_AGENTS.md 分别适配不同 agent 工具。扣分点:能力边界模糊,README 同时宣称是 CLI、MCP 服务器、操作系统、游戏、支付系统、社交网络(Host)、建站发布平台,边界没有清晰收敛;触发精度方面,多个技能(tune、swarlo、endgame、aeo)的触发词重叠且部分技能依赖本地路径(~/arena/empire/swarlo、/workspace/atris/...)与特定机器布局,换环境即失效;环境适配方面,macOS 沙箱测试单独跑、Linux CI 跳过,说明部分安全边界只在特定平台成立,而包内未说明其他平台的行为差异。
信息架构清晰:README 有 Critical Files 表、目录树、Core Commands 表,AGENTS.md 有 Core Files 与 Proof Surfaces 表。安装说明完整(npm install -g、Node 版本、atris init)。示例丰富。许可证为完整 MIT 文本,版权方明确,给满分。扣分点:命名稳定性差,README 自己承认 dispatch/go 是 run 的别名、up 是 wake 的别名,且 `--legacy` 保留旧链路,说明命令名在演进中不稳定;已知限制只有零散提及(Node 版本、autoland 需手动开启),没有集中的 limitations 章节;版本号在 package.json(3.82.14)与 marketplace.json(1.0.0)不一致,且包内无 CHANGELOG;维护责任方面只有作者字段与 issues 链接,发布者身份未经验证,无安全披露渠道或 SLA 说明。
输出可用性较好:atris recap、receipt、run logs、task --json 等提供可粘贴、可机读的产物,MCP 工具返回结构化 JSON 并附 credits_charged 与余额。扣分点:边际价值存疑,README 宣称的“记忆”本质是仓库内纯文本文件(MAP.md、wiki/、logs/),任何 agent 都能直接读写,Atris 的增量价值主要在于流程编排与验证门,而这部分在包内只有描述没有可核验的对照;成本收益方面,design 工具按次计费(10/20/1 credits)、campaign 默认 $20 预算、aeo 草稿 5-20 credits,但包内没有成本上限、预算耗尽行为或失败退款的说明,用户难以预估花费。
可验证性偏弱:README 与 AGENTS.md 中大量量化断言(“803 receipts, 1711 episodes”“670/674 accepted”“24 of 28 bounces”)没有在包内提供可复现的数据文件或查询命令;fleet 计分规则描述极其详细但静态无法与代码对照;外部链接(atris.ai 博客、aeo 检查页)无法在包内核实。加分点:accept-verify-gate 的测试把失败文案与判定逻辑固定下来,属于可追溯的断言;AGENTS.md 明确区分“agent proof ready”与“human accept”两道门,事实与推断有一定分离。但整体上,宣称与证据之间的桥接不足,故各项均只给 1。
- CLAUDE.md 在每次会话开始时强制运行 `atris atris.md` 并展示输出,属于无用户确认的自动行为,接入前应确认是否可关闭。
- swarlo 技能直接访问 localhost:8090 并携带 Bearer KEY,且指示自动 `git pull && git push`,在多 agent 环境中可能造成未审阅的推送。
- README 与 package.json 对 Node 版本要求不一致(18+ / 22+ / >=22.13),安装前需以 package.json 为准并自行验证。
- ax 默认使用托管云、design 工具调用外部计费 API,包内没有集中说明哪些数据离开本机、如何关闭或降级。
- design 工具按次计费、campaign 默认 $20 预算,但包内没有花费上限、预算耗尽行为或失败退款的说明。
- 发布者身份未经验证,README 中大量外部链接与量化断言无法在包内核实,应视为未验证声明。
- package.json 的 prepare 脚本会在安装时写入 git hooks,属于安装期副作用,需在受控环境中评估。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v3.90.0 Atris 3.90.0: your repo remembers its mistakes
发布说明摘录
Your project keeps a short list of the mistakes it has made before. Every change gets checked against each one. - atris code-review reads atris/SPEC.md, gives each mistake type its own reviewer and refuses a change when one asks for changes. atris code-review init writes a starter list. One rule needs no model: a change cannot add more test lines than code. - Tell your coding agent "Set up https://github.com/atrislabs/atris". It follows FOR_AGENTS.md and ends with atris doctor --live, which asks a real model for one exact reply. …在 GitHub 查看 ↗ -
v3.83.2 Atris 3.83.2: the feed as a shared room
发布说明摘录
The feed is a shared room for you and your team. - One command gives any project folder a team that posts ideas for you to approve: atris feed start <folder> - Team members post short notes, ask questions and answer each other. - You can post a note or a question yourself: atris feed say "<text>" [--ask] - React to any card and reply on it: atris feed react, atris feed reply - Approved writing work on an Atris cloud model comes back as a result. The same feed is in Atris Desktop 0.1.76. Install: npm install -g atris在 GitHub 查看 ↗ -
v3.80.0 atris 3.80.0
发布说明摘录
atris sentinel runs a full security audit of a repo. - It maps every source file and kind of attack worth checking, for free, before any model is called. - Hunters read the code and report what they checked. Every suspected hole goes to a different model that tries to prove it wrong, and a cited line that does not exist is thrown out first. - Runs add up. Areas whose code did not change stay covered, old findings get re-checked, and the next run spends its budget on what is left. …在 GitHub 查看 ↗
常见问题
Atris 是否要求使用某一家模型提供商?
运行 Atris 需要什么 Node.js 版本?
atris task 使用内置 SQLite,需要 Node.js 22 或更高版本。任务如何判定完成?
--verify 命令;成员任务会运行检查并由另一引擎复核。人工接受任务需要 atris task accept。云工作区是否是必需的?
atris setup 配置。Atris 项目工作台 官网是什么?
Atris 项目工作台 免费吗?
Atris 项目工作台 开源吗?
Atris 项目工作台 安全吗?
Atris 项目工作台 还在维护吗?
Atris 项目工作台 是谁开发的?
谢谢反馈,我们会据此改进页面。