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.
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.
Reviewed 2026-08-18
Topics
- Stars
- 22★
- Forks
- 0
- Language
- Rust
- License
- Apache-2.0
- Created
- 2026-02-23
- Last push
- 2026-08-18