cytostack/openwolf

Portable project memory across Claude Code, Codex and OpenCode, plus token accounting measured from harness transcripts. Local file I/O, no API calls, no telemetry.

解决的问题

AI 编码代理经常因重复读取相同文件、将大量 Bash 输出写入上下文窗口，或在不同 AI 代理之间切换或启动新会话时丢失项目特定知识和约定而浪费令牌。OpenWolf 提供了一个跨不同工具持久存在的共享、耐用的内存层，防止重复的令牌使用。

工作原理

OpenWolf 将生命周期钩子（Node.js 脚本）安装到支持的编码代理中。它在项目根目录创建一个 .wolf/ 目录，作为包含项目索引、错误日志和会话交接信息的“大脑”使用。

关键机制包括：

  • Bash 管理器：在 Bash 输出（超过 2,000 个令牌）进入代理上下文前进行压缩，同时将完整文本保留在磁盘上。
  • 持久化索引：使用项目索引，使代理能够定位符号并读取特定行范围，而无需读取整个文件。
  • 上下文恢复：在上下文压缩或会话开始后重新注入规则和状态，防止代理“忘记”指令。
  • 测量：扫描转录文本，报告实际令牌使用量并验证节省效果。

适用人群

使用 Claude Code、Codex CLI、OpenCode、Cursor 或 Gemini CLI 等 AI 编码代理，并希望降低令牌成本、在不同工具间保持一致项目记忆的开发者。

主要亮点

  • 跨代理记忆：在不同 AI 工具间持久存在的项目状态（惯例、错误修复等）
  • 令牌优化：通过压缩 Bash 输出和提供精准文件读取，减少上下文膨胀
  • 验证报告：通过实际转录文本测量真实使用量，而非依赖启发式估算的仪表板和报告工具
  • 本地优先：纯本地文件 I/O，无 API 调用或遥测
  • 集成技能：内置项目交接、安全审计和 UI 框架迁移命令

相关

  • 项目
    TencentCloud/TencentDB-Agent-Memory

    一个中央记忆服务器和管理枢纽，允许 AI 代理在会话和框架之间共享和复用提炼后的经验、技能和项目知识。

  • 项目
    akitaonrails/ai-memory

    ai‑memory 是一个基于 Rust 的服务器，将代码助手所作的每一次观察（提示、工具调用、会话边界）以纯 Markdown 文件形式存储在 Git 支持的维基中。该服务器可本地运行、在 Docker/Podman 中运行，或在家庭实验室设备上运行，旨在在多个代理（Claude Code、Codex、Cursor、Gemini CLI 等）、机器和团队成员之间共享。代理发布的钩子在会话结束时被整合为可读的维基页面；下一个会话会收到简洁的交接信息，从而能准确接续上一个会话的进度。存储采用人类可读的 Markdown 加上 SQLite 索引（FTS5、实体和可选向量搜索）。默认情况下无需 LLM 或嵌入密钥；可选的 Anthropic/OpenAI 集成可添加 LLM 生成的摘要和语义搜索功能。内置多用户认证、审计日志和个人归属。可通过 Arch AUR、Docker 包装器或原生二进制文件安装，启动服务器，注册客户端及其钩子，系统即可透明运行。

  • 项目
    Team-Commonly/commonly

    一个开源工作区，支持来自任意运行时的 AI 代理协作，为它们提供持久身份和共享项目记忆，消除重复的上下文设置。

  • 项目
    AVIDS2/memorix

    Memorix 是一个 Node.js 库，为任何 AI 编码助手添加本地优先、可搜索的内存存储。它将事实、设计理由和 Git 派生的洞察持久化到 SQLite 数据库中，通过 MCP、CLI 和可选的 Web UI 暴露。通过安装单个 `memorix setup --agent <name>` 命令，数十个助手（Claude Code、Codex、Copilot CLI、Cursor、Gemini CLI 等）可以共享同一项目范围的内存，实现更顺畅的交接、更好的上下文保留和多助手编排。

  • Dispatch
    Codex-maxxing: 将 AI Agent 转化为持久的运行循环

    探索如何通过使用持久线程、共享记忆库和自动化心跳任务，超越一次性提示词，从而创建一个持续的 AI 驱动工作流。