CASS - Coding Agent Session Search

Search across all past agent sessions (Claude, Codex, OpenCode, Gemini).

Quick Reference

Search Past Sessions

# Find how authentication was implemented
cass search "authentication oauth"

# Find how a specific error was fixed
cass search "GLIBC not found"

# JSON output for scripting
cass search "database migration" --json

Agent Integration

# Pre-flight health check
cass health  # Exit 0 = healthy, 1 = unhealthy

# Discover available features
cass capabilities

# API schema for automation
cass introspect

Index Sessions

Run periodically to index new sessions:

cass index

Verify Installation

# Check installed
which cass && cass stats

# Check health
cass status

When to Use

• "I solved this before" → cass search "topic"
• "How did we fix X?" → cass search "error message"
• "What approach did we use for Y?" → cass search "feature name"

Limitations

• epyc6: Requires GLIBC 2.39 (Debian 12 has 2.36)
• Index lag: New sessions need cass index to be searchable

Last Updated: 2026-01-14 Repository: https://github.com/Dicklesworthstone/coding_agent_session_search