Repolode
lovstudio

lovstudio/Ataru

面向本地 AI 编程会话历史的检索工具,提供 Rust 检索内核、JSON CLI 与桌面 GUI。

Star
361
Fork
40
未关闭 Issue
15
最近提交
2个月前

这是什么?

Ataru 将 Claude、Codex 等本地 AI 编程代理的会话记录整理成可检索的记忆层。它把不同来源的 transcript 统一归一化为 Project、Session、Run 和 Turn 等记录,支持用关键词、短语或自然语言问题找回此前的故障处理、命令或架构决策,并可按 Turn、Run、Session 或 Project 粒度聚合,回到原始消息和行号。

关键词检索基于 Tantivy 与 Jieba 分词,中文、代码标识符、包名和错误信息可以一起被索引。通过 OpenAI 兼容 Embeddings 接口的语义召回是可选功能,需要用户显式开启;不可用或超时时会回退到关键词结果并给出警告。索引属于可重建的派生数据,原始会话文件只读。

同一套搜索契约通过 Tauri 桌面应用(React 19)、Rust SDK 与 API,以及无界面的 JSON CLI 提供。CLI 目前只支持关键词检索;项目还发布了两个 Agent Skill,用于封装索引构建与搜索流程。

核心功能

  • 01统一索引本地 Claude 与 Codex 会话文件
  • 02基于 Jieba 的中文分词关键词检索
  • 03结果可按 Turn、Run、Session 或 Project 聚合
  • 04稳定 ID 与行号可回溯到原始消息
  • 05可选语义召回,不可用时自动回退到关键词检索
  • 06增量索引,重建失败时保留上一个健康索引

适用场景

  • 在 AI 编程代理的历史会话中找回以前的排障过程或命令
  • 跨同一项目的多次代理对话查找既往架构决策
  • 通过 JSON CLI 让脚本或 Agent 查询自己的历史记录
  • 在本机离线检索中英文混合的代理会话记录

标签

常见问题

Ataru 是什么?
面向本地 AI 编程会话历史的检索工具,提供 Rust 检索内核、JSON CLI 与桌面 GUI。 Ataru 将 Claude、Codex 等本地 AI 编程代理的会话记录整理成可检索的记忆层。它把不同来源的 transcript 统一归一化为 Project、Session、Run 和 Turn 等记录,支持用关键词、短语或自然语言问题找回此前的故障处理、命令或架构决策,并可按 Turn、Run、Session 或 Project 粒度聚合,回到原始消息和行号。
Ataru 可以免费使用吗?用的什么许可证?
Ataru 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
Ataru 还在维护吗?
半年内有更新。Ataru 最近一次提交是在 2026年8月24日。
Ataru 适合用来做什么?
在 AI 编程代理的历史会话中找回以前的排障过程或命令 跨同一项目的多次代理对话查找既往架构决策 通过 JSON CLI 让脚本或 Agent 查询自己的历史记录 在本机离线检索中英文混合的代理会话记录
在哪里获取 Ataru?
源代码和安装说明在 GitHub 上:https://github.com/lovstudio/Ataru

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目