cass

CASS - コーディングエージェントのセッション検索

複数のエージェントでの AI コーディングセッション履歴を検索して確認できます。

前提条件

cass をインストールします：

# Install via cargo or download binary
cargo install cass

インデックスを構築します：

cass index

CLI リファレンス

セッションを検索

# 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

対応エージェント

• 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

エージェント間で学ぶ

# 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. エージェントで絞り込む - 使用したツールを覚えている場合に使います
5. タイムラインを使用 - 時系列で確認する場合に使います
6. 価値のあるセッションをエクスポート - 重要な会話を Markdown として保存します