casslisted

# 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! ```bash # WRONG - blocks terminal cass # CORRECT - JSON output for agents cass search "query" --robot cass search "query" --json # alias ``` **Always use `--robot` or `--json` flags for machine-readable output.** --- ## Quick Reference for AI Agents ### Pre-Flight Check ```bash # Health check (exit 0=healthy, 1=unhealthy, <50ms) cass health # If unhealthy, rebuild index cass index --full ``` ### Essential Commands ```bash # Search with JSON output cass search "authentication error" --robot --limit 5 # Search with metadata (elapsed_ms, cache stats, freshness) cass search "error" --robot --robot-meta # Minimal payload (path, line, agent only) cass search "bug" --robot --fields minimal # View source at specific line cass view /path/to/session.jsonl -n 42 --json # Expand context around a line cass expand /path/to/session.jsonl -n 42 -C 5 --json # Capabilities discovery cass capabilities --json # Full API schema cass introspect --json # LLM-optimized documentation cass robot-docs guide cass robot-docs commands cass robot-docs schemas cass robot-docs examples cass