aigent-OS
让 Claude Code 在上下文将满时自我刷新：写出校验过的胶囊、执行 /clear、在新会话里接着干，而不是压缩摘要。
- Star 数
- ★ 23
- 最近更新
- 今天
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Claude CodeCodex（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 长时间跑同一个任务的 Claude Code 用户：希望跨过上下文上限继续工作，而不想反复口述背景。
- 不适合
- 需要在 v1.1.0-rc.1 上长期无人值守运行的团队（清除步骤可能卡住）
- 只用 PowerShell、没有 Git Bash 的 Windows 用户
- 想把记忆交给托管数据库、而非本地 Markdown 文件的团队
- 源码审查
- 75/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
aigent-OS 是一个基于 MIT 协议的 Claude Code 运行框架（harness），核心是 Managed Auto-Refresh：当上下文达到阈值（默认 80%，可用 AIGENT_PRESSURE_THRESHOLD_PCT 调整）时，它请求一次 /context-capsule，等待准确的完成确认“Capsule Complete, Ready For Clear”，提交恰好一次 /clear，确认出现新的 SessionStart 会话身份，再提交一次 resume 唤醒，让新会话加载胶囊继续工作。围绕这条循环还有操作层：16 篇 system/ 内核文档、Caddy 技能路由钩子、九名固定模型档位的专家子代理、三层记忆、以及用 Markdown 存在 git 里的 vault（每个胶囊周期对应一次真实提交，可 git log 审计）。运行时依赖 Node.js 18+，需要 Claude Code 作为宿主，本地语义检索使用 all-MiniLM-L6-v2 在这台机器上运行；可选 Codex 适配器把一类有界的机械任务交给 codex exec 并只产出待审 diff。它没有自己的服务器，安装方式是一条 install.sh 脚本，支持 macOS、Linux 和 Windows（Git Bash）。README 明确说明 Managed Auto-Refresh 仍是 v1.1.0-rc.1 预发布功能，公开证据只有一台 Windows 机器上的 11/11 次刷新事务。
安装后，install.sh 会写入 <target>/.claude/settings.json：在 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、PreCompact、Stop、SessionEnd 七个事件上挂载钩子，添加 statusLine，并设置 AIGENT_ROOT / AIGENT_VAULT，同时把 skills/ 复制到 .claude/skills/、把 vault/agents/ 的代理定义复制到 .claude/agents/，并安装 node-pty 等依赖。运行时 daemons/ctx-telemetry.mjs 记录当前上下文百分比，daemons/auto-clear-transport.mjs 持有单次清除授权，daemons/pty-runner.mjs 是唯一的 PTY 写入者，把斜杠命令文本和回车分开写入；skills/context-capsule/SKILL.md 负责写胶囊并输出确认字面量；daemons/boot-receipt.mjs 与 sessionstart-reinject.mjs 产生新会话回执；daemons/resume-verb.mjs 加载最新有效胶囊作为历史工作状态。此外 Caddy 钩子会把每条提示词与技能目录匹配并建议合适的技能，daemons/model-tier-guard.mjs 校验每次 Agent 派发是否符合声明的模型档位，本地语义检索脚本 daemons/semantic-search/search-vault.js 按语义搜索 vault；每个胶囊周期结束时，如果安装目录是有远端的 git 仓库，会把 memory 文件夹提交并推送。
- 长时间跑同一个任务的 Claude Code 用户：希望跨过上下文上限继续工作，而不想反复口述背景。
- 单人创始人或技术负责人：同时推进多条线索，需要在第二天打开终端时看到未结话题和优先级。
- 需要审计 AI 记忆的团队：希望每次检查点都是一次可 diff、可回滚的 git 提交，而不是不透明的向量库。
- 使用 Obsidian 的个人：想把 AI 的知识图谱直接放在 vault/ 里浏览和编辑。
- 希望把一类机械任务交给非 Claude 执行器的开发者：通过 Codex 适配器让 codex exec 产出待审 diff。
- 在 macOS / Linux / Windows（Git Bash）上做本地开发、不想部署服务器的操作者：安装即得到一个 aigent 命令和桌面快捷方式。
如何安装或部署这个 Agent？
前置条件：Claude Code、Node.js 18+ 与 npm、bash（Windows 需先安装 Git for Windows，PowerShell 无法直接运行）。先做 dry run 预览，再正式安装：
这个 Agent 有哪些优点和局限？
- 上下文边界由明确的检查点驱动：写胶囊、一次 /clear、一次 resume 唤醒，没有确认就不清除，逻辑可读可查。
- 记忆是 git 里的纯 Markdown：每个胶囊周期一次提交，可用 git log 审计、diff 和回滚，并可直接用 Obsidian 打开 vault/。
- 安装器提供 --dry-run 逐项列出将要修改的文件，并对冲突文件做备份与 .aigent/quarantine/ 隔离。
- 除刷新循环外还有可用的操作层：技能路由、模型档位校验、三层记忆、九名专家子代理和本地语义检索。
- 支持 macOS、Linux 和 Windows（Git Bash），CI 在三个平台跑安装器，且不修改用户级 ~/.claude/settings.json。
- Managed Auto-Refresh 仅在 v1.1.0-rc.1 预发布中提供，GitHub 标记的最新版 v1.0.0 早于它；长会话在 rc.1 上可能停在清除步骤，需要手动 /clear。
- 公开证据仅为单机单席位 11/11 次事务，README 明确不构成可靠性或优于压缩的结论。
- 每次刷新都要额外消耗 token（写胶囊、读胶囊），并且必须依赖 Claude Code 作为宿主。
- 默认安装需要 node-pty 等原生依赖；用 --no-deps 会退回到没有自动清除的非托管启动方式。
- 在克隆目录安装时，origin 指向公共仓库，胶囊周期会把记忆推送到该仓库，必须先改远端或删除。
- 部分功能（Hindsight/Jev 记忆桥、fleet-band、fleet-delivery）只在 master 上、不在发布版中，且 fleet-delivery 依赖本仓库未包含的消息房间与任务源。
这个 Agent 与同类方案有什么区别？
README 给出了同类工具的定位对照：claude-mem 自动捕获会话内容、用 AI 压缩后注入后续会话，存储（SQLite + Chroma）不在版本控制内；mksglu/context-mode 减少工具输出占用的上下文并把会话事件存入 SQLite；tigerless-labs/agent-memory 提供 Claude Code 与 Codex 共享的 Markdown 长期记忆与本地检索索引；vectorize-io/hindsight 是跨代理学习的记忆服务（aigent-OS 有可选的桥接）；mvschwarz/openrig 面向持久的多代理团队。README 的自我定位是：会话连续性与跨会话记忆已是成熟品类，aigent-OS 目前领先之处在 git 原生可审计性，并明确不宣称优于自动压缩。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| aigent-OS 当前 | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 23 | 今天 | JavaScript | Claude Code |
| Vibe Coding 中文实战指南 | 38 · 缺口较多 | 命令行工具免费 | ★ 18k | 2 天前 | Makefile | Codex · Claude Code |
| Claude Codex Settings | 48 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.2k | 今天 | Python | Codex · Claude Code |
| RecallLoom 项目记忆 | 证据不足 | Agent 插件 / 技能免费 | ★ 153 | 2 个月前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
安装器文档明确说明不修改用户级 ~/.claude 配置、不使用 sudo、不写目标目录之外，且对符号链接写入做拒绝处理，最小权限有据可查（2）。但 hooks 以用户 OS 权限运行、authority matrix 仅为文档而非技术强制，安全文档自己承认这一点，故未给满分。用户确认方面有 --dry-run 预览与备份机制，但默认安装会追加 ~/.bashrc、写 PATH、创建快捷方式，属于对用户环境的实质改动，确认粒度偏粗（2）。数据流透明度是本文档最强项：README 与 install-security 逐项列出网络访问（npm、Hugging Face 模型、vault git push、可选 bridge/codex），并明确提示克隆目录 origin 指向公共仓库需改私有（3）。敏感数据处理有凭据脱敏、confidential deny list、持久化文本 renderPersisted 边界，但均为防御纵深且自述非保证，明文 markdown 存储依赖磁盘加密（2）。依赖安全使用 npm ci --ignore-scripts 并锁定，但未提供 SBOM 或漏洞扫描证据（2）。外部效应包括自动 /clear、git commit/push、launcher 写 PATH，均有文档与回滚说明，但自动推送与自动清屏属高影响动作（2）。回滚文档详尽：备份、quarantine、卸载步骤、doctor 诊断（3）。来源归属：LICENSE 署名 Will Gwyn，README 关联 theaigent.xyz 与配套论文，但发布者身份未经 FollowAgents 验证，且无签名发布，故仅 1。
自洽性：文档多处主动披露 rc.1 已知缺陷（长会话停在 clear 步）、路径不一致（ACTIVE_STATE.json 写入与读取路径分裂）、旧文档错误已更正，说明作者诚实但系统当前存在已知不一致（2）。依赖可用性：Node 18+、bash、可选 Python3，npm 锁文件与 CI 三平台安装测试支持，但 node-pty 需本地重建、Hugging Face 首次下载模型，存在环境依赖风险（2）。失败信息：doctor.sh、--dry-run、[quarantine]/[skip] 提示、DEGRADED/UNKNOWN 退出码语义均有文档，但 DEGRADED 退出 0 需解析字符串而非退出码，属易误用点（2）。
受众与场景：面向长期运行 Claude Code 单席位用户，FAQ 覆盖 compaction 对比、Windows、成本、数据出境等真实问题（2）。能力边界：README 用表格逐项标注 On by default / Opt-in / Experimental / Roadmap，并明确 authority matrix 非强制、注入扫描不阻断，边界表述罕见地清晰（3）。触发精度：阈值默认 80% 可配 AIGENT_PRESSURE_THRESHOLD_PCT，需精确确认短语才 clear，但 rc.1 存在 ack 边界缺陷（#90/#91 已修未发版），触发可靠性仍有缺口（2）。环境适配：Windows 需 Git Bash、macOS 实机验证最少、CI 覆盖三平台，适配面广但成熟度不均（2）。
信息架构：README 分区清晰，docs/ 下 getting-started、install-security、security 分工明确，状态布局图完整（3）。安装说明：dry-run、--target、--no-deps、--trust-existing、operator-owned 声明、校验和固定安装均有详述（3）。命名稳定性：/open 与 /close 已退役但文件保留，ACTIVE_STATE 路径分裂，命名与路径存在历史包袱（2）。示例与 FAQ：FAQ 条目丰富，含可直接执行的注入扫描测试命令与卸载步骤（3）。已知限制：专设 Evidence and limits 节，列出单席位证据、rc.1 缺陷、未验证的 bridge（3）。许可证：MIT 全文在库（3）。版本与变更：README 提及 v1.1.0-rc.1 与 v1.0.0，但 CHANGELOG 未在证据中提供，版本状态（Latest 标记落后于 rc）易混淆（2）。维护责任：SECURITY.md 说明由个人维护、响应目标非 SLA、私有漏洞通道尚未启用，责任明确但资源单薄（2）。
输出可用性：capsule 为 markdown 可读可 diff，git 可回滚，输出形态对操作者友好（2）。边际价值：以显式检查点替代模型摘要，是真实差异化取舍，但作者明确不主张优于 compaction，且单席位 11/11 证据不足以证明普适收益（2）。成本收益：免费 MIT，但每轮刷新消耗额外 token 写读 capsule，且需 Node/npm/node-pty 依赖与首次模型下载，收益依赖长会话场景（2）。
主张可追溯：README 将 11/11 证据指向配套论文与案例研究，缺陷指向具体 PR/issue 编号，可核对（2）。交叉印证：CI 工作流与文档描述一致（安装测试、daemon 测试、doctor 校验），但核心 Auto-Refresh 行为无公开可复现测试证据，仅单席位自述（2）。事实与推断分离：文档反复区分“已展示”“未主张”“roadmap”，并明确 demo 为脚本动画非录屏，这一分离做得扎实（3）。
- 默认安装会追加 ~/.bashrc、修改 PATH 并创建快捷方式，且 vault 同步会在有 remote 时自动 commit 并 push；克隆目录的 origin 指向公共仓库，使用前务必改为私有仓库或移除 origin。
- v1.1.0-rc.1 存在长会话停在 clear 步的已知缺陷，相关修复仅在 master 未发版；依赖自动清屏的流程需准备手动 /clear 兜底。
- authority matrix 与注入扫描均为提示层而非强制控制，不能作为安全边界；真正的强制需依赖 Claude Code permissions 与操作系统控制。
- 发布者身份未经 FollowAgents 验证，发布未签名，建议固定 commit 或校验和安装并自行审阅 install.sh。
- 文档自述 ACTIVE_STATE.json 写入与读取路径不一致，可能导致状态读取为空，需运行 doctor 与 --print-vault 核实。