cass

Files (1)

• SKILL.md

SKILL.md (first lines)

<objective>
Help the user install, search, explore, and export their Claude Code sessions using the `cass` CLI and the optional `cass-memory` (`cm`) reflection pipeline.
</objective>

<requirements>
Two tools — independent, loosely coupled:

| Tool | Role | Required |
|------|------|----------|
| `cass` | Infrastructure: index, search, export sessions | Yes |
| `cm` (`cass-memory`) | Intelligence: reflect on sessions, build playbook rules | Optional |

Check if installed:
```bash
cass --version   # expect: cass 0.x.x
cm --version     # expect: cass-memory 0.x.x (optional)
```
</requirements>

<setup>

```bash
# Install cass (session indexer)
brew install dicklesworthstone/tap/cass
cass index --full   # ~2 min first run

# Install cm / cass-memory (reflection pipeline) — optional
brew install dicklesworthstone/tap/cm
# or one-liner: curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/cass_memory_system/main/install.sh" | bash -s -- --easy-mode --verify

# Configure LLM provider for cm (one of):
export ANTHROPIC_API_KEY=sk-ant-...
cm init && cm doctor   # verify cass + LLM OK
```

</setup>

<quick_start>
1. Check index freshness: `cass status --json`
2. If stale (recommended_action = "index"), run: `cass index`
3. Execute the user's request (search / export / context / timeline)
</quick_start>

<process>

## Step 1: Pre-flight Check

Always run this first:

```bash
cass status --json
```

Key fields to check:
- `recommended_action`: `"ok"` = index is fresh; `"index"` = needs reindexing
- `db_stats.total_sessions`: how many sessions are indexed
- `freshness.stale`: true if index is stale

If stale, run:

```bash
cass index
```

Skip re-indexing if the user is searching a session they already know the path to (direct export).

---

## Step 2: Execute the Request

### Search sessions

```bash
# Basic search
cass search "topic keyword" --json --fields summary

# Limit to current workspace
cass search "keyword" --json --fields summary --workspace $(pwd)

# Filter by time
cass search "keyword" --json --fields summary --days 7

# Filter by agent (claude_code, cursor, codex, aider, etc.)
cass search "keyword" --json --fields summary --agent claude_code

# Chained search (narrow down results)
cass search "first topic" --robot-format sessions | cass search "second topic" --sessions-from -
```

Output fields in `--fields summary`: `source_path`, `line_number`, `agent`, `title`, `score`.

### Export a session

```bash
# Export to stdout (review inline)
cass export ~/.claude/projects/<workspace-encoded>/<session-id>.jsonl

# Export to file
cass export <path-to-session.jsonl> -o /tmp/session.md

# Include tool call details
cass export <path> --include-tools
```

Session files live at: `~/.claude/projects/<workspace-encoded>/` — encode workspace path by replacing `/` with `-`.

### Find related sessions for a file

```bash
cass context <path-to-session.jsonl> --json --limit 5
```

Returns sessions that worked in the same workspace or touched the same files.

### View activity timeline

```bash
# Last 7 days
cass timeline --days 7

From durandom/skills, GPL-3.0.

More from durandom/skills