AI编程工具共享对话索引

Clancey是一个为AI编程工具设计的共享对话索引服务,能够整合多个AI编程工具的历史对话,支持跨工具会话检索与语义搜索。

  • by divmgl
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 divmgl/clancey

使用说明

克兰西

克兰西是一个 共享对话索引 AI编码工具。它将您在Claude Code、Grok Build、OpenCode、Codex和Hermes中已经完成的操作导入到一个地方,因此这些代理中的任何一个都可以回答:

  • “哪次谈话产生了 feature/auth 分支?"
  • “上次我们碰的时候说了什么 GameRepository.ts?"
  • “我们为什么要将身份验证转移到边缘——这是在哪个客户端决定的?”

你问你现在的经纪人;它查找Clancey所知道的每个客户的会话,然后读回实际说过的话。

支持的工具

工具 历史导入 实时捕捉 MCP+技能
Claude 代码 是 是 是
Grok建筑 是 是 是
开源代码 是 是 是
法典 是 是(MCP运行时) 是
赫尔墨斯代理 是 --(state.db) 是

一家店铺(~/.clancey/).设置每个工具的MCP服务器并安装 克兰西技能 所以特工们知道如何查东西。实时捕获文件编辑和shell命令是分支/文件映射的静默基础设施,它不指导代理。

可选:在您工作时,该技能还可以让代理记录决策和学习,以便以后语义搜索更加丰富。查找工作没有这个;进口成绩单就足够了。

先决条件

  • 节点18+
  • 上述支持的编码工具中至少有一个

安装和设置

npx -y clancey setup

安装程序会询问要启用哪些工具,从每个工具中导入现有历史记录,以便您可以立即询问,并安装Clancey技能。完成后重新启动工具。第一次运行会下载一个小型嵌入模型(约30 MB),然后缓存。

使用它

你从不直接给克兰西打电话。每当你询问过去的工作时,你的经纪人都会这样做,包括在某个工作日发生的工作 不同的 编码客户端比你现在使用的客户端更强大。

你可以问的问题:

  • “是哪场对话产生了这场公关?” / “ feature/auth 分支?"
  • “我上次改变的时候在想什么 GameRepository.ts?"
  • “我们最近在这个回购中做了什么?”
  • “食品法典委员会做了什么 feat 上周?" (或克劳德、格鲁克、OpenCode、爱马仕)
  • “搜索我们一周前说的关于边缘认证的所有内容。” / “…昨天。” / “…在过去的7天里。”

Clancey可以通过以下方式确定范围 仓库 (结账路径或 owner/name), 分支, 哪种编码工具,以及 简明英语时间 (“上周”、“一周前”、“昨天”)。它可以列出最近的会话,打开完整的记录(包括子代理回合),如果原始聊天文件被修剪,则可以回退到快照。

虽然任何编码客户端都打开了Clancey MCP,但只有一个后台 clancey watch 通过重新摄取更改的转录本来保持索引的新鲜度。对于普通工作,您不需要手动运行回填。如果仍然缺少某些内容,请让代理刷新索引(或运行 npx clancey backfill).

可选富集: 当你工作时,代理可能会记录决策和学习(提交、PR、根本原因、方法选择),这样以后的搜索会更清晰。您还可以要求它在事后挖掘旧会话以做出决定。没有这个,查找就可以了——导入的历史记录就足够了。

保留您的历史记录

[!重要] Claude Code默认在30天后删除聊天记录,所以要尽早这样做。Clancey会快照它导入的对话,因此它已经看到的任何内容都可以保留下来,但提高窗口会使对话保持足够长的时间,以便首先导入:

{
  "cleanupPeriodDays": 3650
}

命令

你只会跑 setup 手工;你的经纪人为你管理其他一切。安装程序将MCP服务器、技能和实时捕获固定到此安装中,因此在您重新运行之前,后续版本不会更改您的设置。

npx clancey setup       Set up Clancey and import history (run once)
npx clancey backfill    Re-import / refresh the conversation index
npx clancey watch       Background indexer (auto-started by MCP; one instance)

当结果看起来过时时,您的代理还可以从会话内部刷新索引。跑 npx clancey --help 查看完整列表。Clancey商店里的一切 ~/.clancey/.

发展

bun install
bun run typecheck
bun run test
bun run build

许可证

麻省理工学院