Repolode
Submit
lovstudio

lovstudio/Ataru

Local-first search over your Claude and Codex session history, with a Rust search core, JSON CLI, and desktop app.

View on GitHubWebsite
Stars
361
Forks
40
Open issues
15
Last commit
2 months ago

What is it?

Ataru turns past AI coding sessions from local agent transcript files into a searchable memory layer. It normalizes sessions from sources such as Claude CLI, Claude App/Web and Codex into Project, Session, Run, Turn and Message records, then indexes them for keyword search with Tantivy and Jieba, which also handles Chinese text, code, package names and error strings.

Queries can be grouped at turn, run, session or project level, and each hit keeps stable IDs, role, timestamp and line number so you can jump back to the original context. Keyword search works fully offline. Semantic recall via an OpenAI-compatible embeddings provider is opt-in, and when it is unavailable the response falls back to keyword results with an explicit warning.

The search logic lives in a shared Rust SDK and API, used by a Tauri/React desktop app, a JSON CLI for scripts, and an Agent Skill workflow of ensure index, search, then inspect.

Key features

  • 01Unified indexing of local Claude and Codex session transcripts.
  • 02Chinese-aware full-text keyword search built on Tantivy and Jieba.
  • 03Results grouped by turn, run, session or project.
  • 04Stable project, session, message IDs with line numbers for jumping back to source.
  • 05Optional semantic recall that falls back to keyword search when unavailable.
  • 06JSON CLI and Agent Skill share the same search contract as the desktop app.

Use cases

  • Finding a past debugging fix or command you worked out with an AI coding agent.
  • Recalling why an architectural decision was made weeks ago across several projects.
  • Letting an agent query its own local history through the JSON CLI or a Skill.

Topics

#agent-memory#full-text-search#local-first#rust#tantivy#semantic-search#tauri#claude-code#ai-memory#ai-tools

FAQ

What is Ataru?
Local-first search over your Claude and Codex session history, with a Rust search core, JSON CLI, and desktop app. Ataru turns past AI coding sessions from local agent transcript files into a searchable memory layer. It normalizes sessions from sources such as Claude CLI, Claude App/Web and Codex into Project, Session, Run, Turn and Message records, then indexes them for keyword search with Tantivy and Jieba, which also handles Chinese text, code, package names and error strings.
Is Ataru free to use? What license does it have?
Ataru is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is Ataru still maintained?
Updated within 6 months. The last commit to Ataru was on Aug 24, 2026.
What can I use Ataru for?
Finding a past debugging fix or command you worked out with an AI coding agent. Recalling why an architectural decision was made weeks ago across several projects. Letting an agent query its own local history through the JSON CLI or a Skill.
Where can I get Ataru?
The source code and installation instructions are on GitHub: https://github.com/lovstudio/Ataru

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects