cass

CASS - 编码 Agent 会话搜索

跨多个 Agent 搜索和探索你的 AI 编码会话历史。

前提条件

安装 cass：

# Install via cargo or download binary
cargo install cass

构建索引：

cass index

命令行参考

搜索会话

# Basic search
cass search "query" --json

# With wildcards
cass search "react*" --json
cass search "*hook*" --json

# Limit results
cass search "query" --limit 20 --json

# Filter by agent
cass search "query" --agent claude --json
cass search "query" --agent codex --json
cass search "query" --agent cursor --json
cass search "query" --agent gemini --json
cass search "query" --agent aider --json

# Filter by workspace/project
cass search "query" --workspace /path/to/project --json

# Filter by time
cass search "query" --days 7 --json

# Output detail levels
cass search "query" --fields minimal --json  # paths only
cass search "query" --fields summary --json  # default
cass search "query" --fields full --json     # everything

# Highlight matches
cass search "query" --highlight --json

检查健康状态

# Verify index is healthy before searching
cass health

构建/重建索引

# Full rebuild
cass index --full

# Watch mode for continuous updates
cass index --watch

查看会话详情

# View specific line from search results (path is positional)
cass view /path/to/session.jsonl -n 42 --json

# With more context lines
cass view /path/to/session.jsonl -n 42 -C 10 --json

展开上下文

# Show surrounding messages around a line (path is positional, -n is required)
cass expand /path/to/session.jsonl --line 42 -C 3 --json

# More context
cass expand /path/to/session.jsonl --line 42 -C 10 --json

活动时间线

# Activity across agents
cass timeline --json

# Last N days (use relative format)
cass timeline --since 7d --json

# Today only
cass timeline --today --json

# By agent
cass timeline --agent claude --json

# Group by hour or day
cass timeline --group-by hour --json
cass timeline --group-by day --json

导出对话

# Export to markdown (path is positional)
cass export /path/to/session.jsonl --format markdown

# Export to HTML
cass export /path/to/session.jsonl --format html -o conversation.html

# Export to JSON
cass export /path/to/session.jsonl --format json

# Include tool calls
cass export /path/to/session.jsonl --include-tools

统计信息

# Index statistics
cass stats --json

功能

# Show supported features and connectors
cass capabilities --json

查找相关会话

# Find sessions related by workspace, day, or agent (path is positional)
cass context /path/to/session.jsonl --json

# Limit per relation type
cass context /path/to/session.jsonl --limit 3 --json

支持的 Agent

• claude - Claude Code 会话
• codex - OpenAI Codex CLI
• cursor - Cursor IDE
• gemini - Gemini CLI
• aider - Aider
• chatgpt - ChatGPT（如果已导出）

工作流模式

查找过往解决方案

# Search for how you solved something before
cass search "authentication jwt" --json
cass search "postgres connection pool" --json
cass search "react state management" --json

回顾最近的工作

# What did I work on today?
cass timeline --today --json

# Last week's activity
cass timeline --since 7d --json

深入探究某个会话

# 1. Search for topic
cass search "bug fix login" --json

# 2. Get line number from results, view details
cass view /path/from/results.jsonl -n 123 --json

# 3. Expand context around interesting parts
cass expand /path/from/results.jsonl --line 123 -C 5 --json

# 4. Export full conversation for reference
cass export /path/from/results.jsonl --format markdown -o reference.md

跨 Agent 学习

# How did different agents handle similar problems?
cass search "api design" --agent claude --json
cass search "api design" --agent codex --json
cass search "api design" --agent cursor --json

最佳实践

1. 先构建索引 - 搜索前先运行 cass index
2. 检查健康状态 - 如果搜索没有返回结果，运行 cass health
3. 使用通配符 - 用 *pattern* 进行灵活匹配
4. 按 Agent 过滤 - 当你记得自己用过哪个工具时
5. 使用时间线 - 用于按时间顺序探索
6. 导出有价值的会话 - 将重要对话保存为 markdown