A local TUI/CLI tool that indexes and searches session histories from 18+ coding agents with full-text, semantic, and hybrid search.
coding-agent-search (CLI command cass) normalizes heterogeneous session logs from 18+ coding agents — including Claude Code, Codex, Cursor, Aider, and Gemini CLI — into a local SQLite database, providing sub-60ms full-text search with optional local semantic search.
Core search is built on Edge N-Gram prefix indexing for O(1) prefix matching, with intelligent tokenization handling snake_case, code symbols, etc. Semantic search uses FastEmbed with MiniLM models for pure local inference. Default hybrid search mode uses lexical as the mandatory fast path with semantic refinement layered when ready, automatically falling back to pure lexical search when models are unavailable.
The interactive TUI (built on FrankenTUI) features a three-panel layout with filter pills, color-coded result list, and syntax-highlighted preview. A --robot/--json non-interactive mode serves AI agent integrations following the stdout=data, stderr=diagnostics, exit 0=success protocol.
All data stays local. HTML export supports AES-GCM encryption. ChatGPT encrypted conversations can be decrypted via macOS Keychain. Built on the author's sibling libraries (FrankenSQLite, FrankenSearch, FrankenTUI) pinned by Git rev. Supports Linux, macOS (Apple Silicon & Intel), and Windows via install script, Homebrew, or Scoop.
Search Engine Features#
| Feature | Description |
|---|---|
| Full-text search | Edge N-Gram prefix index, O(1) lookup, < 60ms latency |
| Smart tokenization | Handles snake_case, hyphenated terms, code symbols (c++, foo.bar) |
| Semantic search (optional) | FastEmbed + MiniLM, pure local inference, zero network at query time |
| Hybrid search | Default: lexical as mandatory fast path, semantic refinement when ready |
| Lexical fallback | Auto-reverts to pure lexical when semantic assets unavailable |
| Zero-stall updates | Background indexer atomic commits, reader.reload() for instant searchability |
Multi-Agent Data Sources#
Covers 18+ agents: Claude Code, Codex, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, Pi-Agent, GitHub Copilot Chat, Copilot CLI, OpenClaw, Clawdbot, Vibe, Crush, Kimi Code, Qwen Code, Factory (Droid). Manage via cass sources agents list/exclude/include.
Robot Mode#
--robot / --json non-interactive mode with subcommands: health, search, sessions, view, expand, robot-docs, sources, resume.
Installation#
# Linux / macOS
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh?$(date +%s)" | bash -s -- --easy-mode --verify
# Homebrew (Apple Silicon macOS + Linux)
brew install dicklesworthstone/tap/cass
# Windows Scoop
scoop bucket add dicklesworthstone https://github.com/Dicklesworthstone/scoop-bucket
scoop install dicklesworthstone/cass
Optional semantic model: cass models install (~90MB download) or cass models install --from-file <dir> (offline).