Agent skill · software engineering · aiskillstore
cass
Coding Agent Session Search - unified CLI/TUI to index and search local coding agent history from Claude Code, Codex, Gemini, Cursor, Aider, ChatGPT, Pi-Agent, Factory, and more. Purpose-built for AI agent consumption with robot mode.
Why this skill is useful
Adds a unified CLI/TUI with executable commands for indexing and searching across multiple coding agent histories, enhancing AI's capability to retrieve relevant past interactions.
What it needs
Requires cass installed locally. About 12k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
CASS - Coding Agent Session Search Unified, high-performance CLI/TUI to index and search your local coding agent history. Aggregates sessions from 11 agents: Codex, Claude Code, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, Pi-Agent, and Factory (Droid). CRITICAL: Robot Mode Required for AI Agents NEVER run bare cass - it launches an interactive TUI that blocks your session! Always use --robot or --json flags for machine-readable output. --- Quick Reference for AI Agents Pre-Flight Check Essential Commands --- Why Use CASS Cross-Agent Knowledge Transfer Your coding agents create scattered knowledge: Claude Code sessions in ~/.claude/projects Codex sessions in ~/.codex/sessions Cursor state in SQLite databases Aider history in markdown files CASS unifies all of this into a single searchable index. When you're stuck on a problem, search across ALL your past agent sessions to find relevant solutions. Use Cases --- Command Reference Indexing Search Session Analysis Status & Diagnostics --- Aggregation & Analytics Aggregate search results server-side to get counts and distributions without transferring full result data: Aggregation Field Description ------------------- ------------- agent Group by agent type (claudecode, codex, cursor, etc.) workspace Group by workspace/project path date Group by date (YYYY-MM-DD) matchtype Group by match quality (exact, prefix, fuzzy) Top 10 buckets returned per field, with othercount for remaining items. --- Remote Sources (Multi-Machine Search) Search across sessions from multiple machines via SSH/rsync. Setup Wizard (Recommended) The wizard: 1. Discovers SSH hosts from ~/.ssh/config 2. Probes each for agent data and cass installation 3. Optionally installs cass on remotes 4. Indexes sessions on remotes 5. Configures sources.toml 6. Syncs data locally Manual Setup Configuration stored in ~/.config/cass/sources.toml (Linux) or ~/Library/Application Support/cass/sources.toml (macOS). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/cass