Cass

What it does

This skill, Cass, provides a unified command-line interface (CLI) and text user interface (TUI) to index and search through your local history of coding agent sessions. It aggregates data from 11 different agents including Codex, Claude Code, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, Pi-Agent, and Factory (Droid). Cass is designed for AI agents and requires the --robot or --json flags to function correctly within an automated workflow.

When to use it

• Troubleshooting coding errors: Search across all your agent sessions to find previous attempts at solving a similar problem.
• Knowledge transfer between agents: Identify patterns, solutions, and approaches used by different AI coding assistants.
• Understanding agent behavior: Analyze session data to understand how various agents respond to specific prompts or code challenges.
• Discovering capabilities of coding agents: Use cass capabilities to explore the features offered by each integrated agent.

Key capabilities

• Cross-agent search: Searches sessions from 11 different coding AI agents.
• JSON output for automation: Provides machine-readable JSON output via --robot or --json flags.
• Metadata retrieval: Allows searching with metadata like elapsed time, cache statistics and freshness information.
• Session viewing & expansion: View specific lines of code within sessions and expand the surrounding context.
• Health checks and index rebuilding: Provides commands to verify the health of the index and rebuild it if necessary.

Example prompts

• cass search "authentication error" --robot --limit 5 - Searches for sessions containing "authentication error" and returns the top 5 results in JSON format.
• cass view /path/to/session.jsonl -n 42 --json - Views a specific session file at line number 42, outputting the result as JSON.
• cass capabilities --json - Lists the supported capabilities of the integrated coding agents in JSON format.

Tips & gotchas

• Robot Mode Required: Always use the --robot or --json flags when using Cass within an AI agent to prevent blocking the terminal with the interactive TUI.
• Index Maintenance: Regularly check the health of the index (cass health) and rebuild it if needed (cass index --full).
• JSON Output is Key: For automated workflows, rely on the --robot or --json flags to ensure machine-readable output.