How do I install the Cass Search skill?

Run npx skillmds@latest add tomevault-io/cass-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cass Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cass Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cass Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cass Search?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cass Search by tomevault-io — Agent Skill

Name: Cass Search
Author: tomevault-io

Cass Search

Search past AI sessions with CASS. Use when looking for past solutions, searching session history, finding how something was done before, or when the user mentions "cass", "history", or "past sessions". Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

CASS (Cross-Agent Session Search)

Search and retrieve content from past AI coding sessions.

When This Applies

Signal	Action
"How did we do this before?"	`cass search`
"Find past solutions"	`cass search`
Looking for patterns	`cass search`
View specific session	`cass view`
Today's activity	`cass timeline`

CRITICAL RULE

Always use --robot or --json. Never run bare cass.

Bare cass launches a TUI that will hang AI agents.

Search

# Basic search
cass search "query" --robot --limit 5

# Lean output (path, line, agent)
cass search "query" --robot --fields minimal

# With summary (title, score)
cass search "query" --robot --fields summary

# Token budget
cass search "query" --robot --max-tokens 2000

# Wildcard prefix
cass search "auth*" --robot

# Workspace-specific
cass search "query" --workspace "/path/to/project" --robot

View & Expand

# View full session
cass view /path/to/session.jsonl --json

# Expand specific line with context
cass expand /path -n 42 -C 3 --json

Timeline

# Today's sessions
cass timeline --today --json

# Last week
cass timeline --since 7d --json

# Recent activity
cass timeline --days 7 --json --limit 10

Export

cass export /path/session.jsonl --format markdown
cass export /path/session.jsonl --format json

Indexing

# If search returns nothing
cass index --full

# Health check
cass health

Output Formats

--robot-format jsonl     # Streaming line-delimited JSON
--robot-format compact   # Minimal output

Query Tips

Query Type	Example
Exact phrase	`"error handling"`
Wildcard	`auth*`
Multiple terms	`database migration`
Recent	Add `--since 7d`

Quick Reference

cass search "query" --robot --limit 5      # Basic search
cass search "query" --robot --fields minimal   # Lean output
cass view /path.jsonl --json               # View session
cass expand /path -n 42 -C 3 --json        # Expand with context
cass timeline --today --json               # Today's activity
cass index --full                          # Rebuild index

When to Use CASS vs Other Tools

Need	Use
Past session content	CASS
Learned patterns/rules	cass-memory (`cm`)
Current codebase	Warp-Grep or Grep
Web documentation	Exa
Task graph	bv

---name: cass-searchdescription: Search past AI sessions with CASS. Use when looking for past solutions, searching session history, finding how something was done before, or when the user mentions "cass", "history", or "past sessions". Use when this capability is needed.---# CASS (Cross-Agent Session Search)Search and retrieve content from past AI coding sessions.## When This Applies| Signal | Action ||--------|--------|| "How did we do this before?" | `cass search` || "Find past solutions" | `cass search` || Looking for patterns | `cass search` || View specific session | `cass view` || Today's activity | `cass timeline` |---## CRITICAL RULE**Always use `--robot` or `--json`. Never run bare `cass`.**Bare `cass` launches a TUI that will hang AI agents.---## Search```bash# Basic searchcass search "query" --robot --limit 5# Lean output (path, line, agent)cass search "query" --robot --fields minimal# With summary (title, score)cass search "query" --robot --fields summary# Token budgetcass search "query" --robot --max-tokens 2000# Wildcard prefixcass search "auth*" --robot# Workspace-specificcass search "query" --workspace "/path/to/project" --robot```---## View & Expand```bash# View full sessioncass view /path/to/session.jsonl --json# Expand specific line with contextcass expand /path -n 42 -C 3 --json```---## Timeline```bash# Today's sessionscass timeline --today --json# Last weekcass timeline --since 7d --json# Recent activitycass timeline --days 7 --json --limit 10```---## Export```bashcass export /path/session.jsonl --format markdowncass export /path/session.jsonl --format json```---## Indexing```bash# If search returns nothingcass index --full# Health checkcass health```---## Output Formats```bash--robot-format jsonl # Streaming line-delimited JSON--robot-format compact # Minimal output```---## Query Tips| Query Type | Example ||------------|---------|| Exact phrase | `"error handling"` || Wildcard | `auth*` || Multiple terms | `database migration` || Recent | Add `--since 7d` |---## Quick Reference```bashcass search "query" --robot --limit 5 # Basic searchcass search "query" --robot --fields minimal # Lean outputcass view /path.jsonl --json # View sessioncass expand /path -n 42 -C 3 --json # Expand with contextcass timeline --today --json # Today's activitycass index --full # Rebuild index```---## When to Use CASS vs Other Tools| Need | Use ||------|-----|| Past session content | CASS || Learned patterns/rules | cass-memory (`cm`) || Current codebase | Warp-Grep or Grep || Web documentation | Exa || Task graph | bv |---## See Also- `cass-memory/` — Cross-agent learning with `cm`- `project-memory/` — Session context retrieval---> Converted and distributed by [TomeVault](https://tomevault.io/claim/eaasxt) — claim your Tome and manage your conversions.

Frequently asked questions