Qarinah

Qarinah 是一款革命性的本地优先项目记忆工具，专为现代 AI 编码工作流设计。它解决了开发者在不同 AI 编码助手（如 Codex、Claude Code、Cursor 等）之间切换时，需要反复重述项目上下文的最大痛点。通过一次简单的 npx 命令初始化，Qarinah 即可为你的项目建立持久、可引用的记忆库，让任何兼容的 AI 助手都能快速“回忆”起项目的历史决策、代码结构和关键约定，无需完整的历史对话记录。

核心功能

Qarinah 的核心在于其本地化、可引用的记忆机制。它自动提取项目中的关键信息，生成结构化的“记忆胶囊”，并支持通过引用（citation）方式在对话中精准调用。这意味着，无论你切换到哪个 AI 工具，它都能通过 Qarinah 快速获取项目背景，保持工作的连续性和一致性。

主要特性

• 本地优先：所有数据存储在你的本地机器上，无需云端账户或 API 密钥，保障数据隐私与安全。
• 极致压缩：官方测试显示，在六个软件任务中，Qarinah 将上下文 token 消耗从 442,113 降至 5,682，减少了 98.71%，同时所有目标均排名前五。
• 无缝切换：支持 Codex、Claude Code、Cursor、CLI 工具及兼容 MCP 的客户端，让你自由选择最佳工具，而无需重述历史。
• 开源免费：采用 Apache-2.0 许可证，完全开源，可自由使用和修改。
• 易于集成：通过 npx 一键安装，与主流开发环境无缝集成。

适用场景

• 多工具协作：在多个 AI 编码助手间切换，保持项目上下文不丢失。
• 大型项目维护：快速向新加入的 AI 助手传递项目历史，加速开发流程。
• 成本优化：显著减少 token 消耗，降低 API 调用成本。
• 团队协作：共享项目记忆，确保团队成员与 AI 助手对项目理解一致。

Qarinah 让项目记忆成为团队资产，让 AI 编码助手真正成为你的得力伙伴。