ahundt/ai-session-search

View on GitHub ↗

Ultra-fast rust-powered AI agent session search and analysis. Search millions of messages in under a second. Claude Code, Claude Desktop, Codex, Cursor, Antigravity, Pi, Google AI Studio, and Gemini CLI. One Rust core behind the aise CLI, an MCP server, a Rust library, and a Python API.

22 ★0 forksRustUpdated 18d ago

What you need to know

aise — a Rust-written search engine (CLI + MCP server) that indexes AI coding assistant session transcripts across nine session formats (Claude Code, Codex, Cursor, Gemini CLI, Antigravity, AI Studio, ChatGPT Codex, Pi, Prime Agent) so agents can answer questions about why a run stopped or which file version was written earlier.

Install

uv tool install ai-session-search && aise integrations install
cargo install ai-session-search --locked && aise integrations install

Usage

  • aise reindex indexes what aise found; aise list / aise search to browse; aise show SESSION_ID and aise resume SESSION_ID to get back to a moment.
  • aise files history src/app.py / aise files extract src/app.py > src/app.py retrieves files.
  • MCP server is the same binary: aise mcp serve (stdio) exposes 8 read-only tools.
  • aise integrations install writes each MCP client's native JSON/TOML (Claude Code, Claude Desktop, ChatGPT Codex, Codex CLI/IDE, Gemini CLI, Antigravity, Cursor, Windsurf, VS Code, Zed, OpenCode, OpenClaw, KiloCode); Pi/Prime Agent get the shared skill + AGENTS.md instead.

Key features

  • Eight MCP tools: search_sessions, search_messages, list_sessions, get_session, get_resume_command, get_index_status, run_skill_capability, and query_session_index (read-only SQL).
  • Indexes harness notices (stop-hook feedback, PreToolUse blocks, local-command caveats) that transcripts never mention.
  • Subagent runs indexed as their own sessions, recording the spawning session.
  • MCP calls are read-only with closed input schemas and no filesystem side effects.
  • Client config stores the absolute path of the first aise on PATH; --binary PATH overrides.

Best for

Developers who want agents to search their Claude Code/Codex/Cursor session history locally by concept rather than by guessing transcript filenames.

Caveats

  • No stable version published yet — uv/cargo resolve the newest release candidate unless you pin an exact version.
  • Not designed for remote/hosted access; the MCP server runs via stdio only.
Platforms: Local

Reviewed 2026-08-18

Topics

aiai-toolsanthropicantigravityclaudeclaude-codeclicodexcursorfastlibraryllmmcpmodel-context-protocolopencodepyo3pythonrustsearchsession-search
Stars
22★
Forks
0
Language
Rust
License
Apache-2.0
Created
2026-02-23
Last push
2026-08-18