Communitygithub.com

Dicklesworthstone/cass

統合化CLI/TUIでローカルのコーディングエージェント履歴(Claude Code、Codex、Gemini、Cursor、Aider、ChatGPT、Pi-Agent、Factoryなど)をインデックス化し検索するツール。AIエージェント向けのロボットモードを搭載。

cass とは?

Cassは、複数のコーディングエージェント(Claude Code、Codex、Gemini、Cursor、Aider、ChatGPT、Pi-Agent、Factoryなど)のセッション履歴を統一的にインデックス化・検索できるCLI/TUIツールです。開発者は過去の作業内容を瞬時に横断検索でき、特にロボットモードではAIエージェント自身が利用することを前提とした構造化データ出力(JSON)が可能です。これにより、AIエージェントが過去の対話やコード生成履歴を参照し、より文脈を理解した上でタスクを実行できるようになります。Cassはローカル環境に完全に閉じて動作するため、プライバシーを保ちながら強力な検索機能を提供します。

対応✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Dicklesworthstone/coding_agent_session_search/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

cass は何をしますか?

コーディングエージェントのセッション検索 - Claude Code、Codex、Gemini、Cursor、Aider、ChatGPT、Pi-Agent、Factoryなど、複数のローカルコーディングエージェント履歴を統一的にインデックス化し検索するCLI/TUIツール。AIエージェントが消費することを目的としたロボットモードを搭載。

機能

  • 複数エージェントのセッション履歴を単一のインデックスに統合
  • 高速な全文検索(Fuzzy検索対応)
  • 直感的なTUIインターフェース
  • AIエージェント向けロボットモード(JSON出力)
  • プライバシー保護:すべてローカルで動作

対応エージェント

エージェントプラットフォーム
Claude CodeAnthropic
CodexOpenAI
GeminiGoogle
Cursorスタンドアロン
Aiderオープンソース
ChatGPTOpenAI
Pi-Agentスタンドアロン
Factoryスタンドアロン

インストール

pip install cass

または、リポジトリをクローン:

git clone https://github.com/Dicklesworthstone/cass.git
cd cass
pip install -r requirements.txt

使用方法

インデックスの作成

cass index --all

特定のエージェントのみインデックス化:

cass index --agent claude-code
cass index --agent codex

検索

cass search "エラーハンドリングの実装"

TUIの起動

cass tui

ロボットモード(AIエージェント用)

cass search "データベース接続設定" --robot

出力例(JSON):

[
  {
    "agent": "claude-code",
    "session_id": "abc123",
    "timestamp": "2025-01-15T10:30:00Z",
    "content": "データベース接続文字列を設定ファイルから読み込むように変更しました。",
    "relevance": 0.95
  }
]

設定

環境変数:

  • CASS_DATA_DIR: データ保存ディレクトリ(デフォルト: ~/.cass)
  • CASS_INDEX_DIR: 検索インデックス保存ディレクトリ

設定ファイル:

~/.cass/config.yaml に保存。

開発

pip install -e .[dev]
pytest

ライセンス

MIT

関連スキル