cass

Search and mine past agent session logs for prompts, decisions, and patterns.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill cass-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cass
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/cass
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill cass-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Your best prompts and key decisions are buried in thousands of past agent session logs. This Skill lets you search, filter, and mine Claude Code, Codex, and Gemini session history to recover working prompts, trace scope decisions, and identify repeated workflow rituals. ## Core Features & Use Cases - Session Search: Query indexed session logs with lexical, semantic, or hybrid modes, using token-efficient flags like --fields minimal and aggregations by agent, date, or workspace. - Prompt Mining: Extract user prompts (lines 1-3 of sessions) and detect ritual prompts repeated 10+ times using jq patterns or the bundled prompt_miner.py script. - Context Recovery: Follow hits with cass view and cass expand, then discover related work clusters with cass context. - Use Case: You remember writing a great extraction prompt weeks ago but can't recall the wording. Run a keyword search filtered to user prompts, view the hit, and copy the exact prompt from the session log. ## Quick Start Ask the agent to search your past sessions for a prompt you used before, for example: find the prompt I used for comprehensive deep dives in this project.

Frequently Asked Questions about cass

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my past Claude Code sessions for a prompt?

Run cass search with your keyword, the workspace path, and --json --fields minimal --limit 50, then pipe to jq filtering hits where line_number <= 3. User prompts live at the top of session files, so this filter isolates what you actually typed.

How do I find repeated prompts in agent session history?

Use the prompt_miner.py script with --workspace to cluster user prompts by normalized text and count occurrences. Prompts appearing 10 or more times are flagged as rituals, indicating proven working patterns worth reusing.

Does cass support Codex and Gemini session logs?

Yes, cass indexes Claude Code, Codex CLI, and Gemini CLI sessions. Claude Code uses .type == "user" while Codex and Gemini use .role == "user", and the skill's references document jq extraction patterns for each format.

Why does cass search return 0 results when the content exists?

The most common cause is a workspace path mismatch, since paths are case-sensitive and must match exactly. Run an aggregation by workspace to discover the exact path, or fall back to rg on the raw session file since cass skips large tool outputs.

Why does cass export fail with a broken pipe error?

Piping cass export output directly to another command causes a broken pipe panic. Always export to a file first with -o /tmp/out.json, then process the file with jq or other tools.