raine/claude-history

Fuzzy-search Claude Code conversation history

claude・history 端末上のUIでClaude Code、Pi、Oh My Piの会話履歴を閲覧する

機能

  • 現在のプロジェクトディレクトリ(またはClaude Code、Pi、OMPのデフォルトセッションフォルダー)をスキャンし、記録されたすべてのチャットセッションのインデックスを構築します。
  • 語彙的または意味的に動作するファジーでフィールド対応の検索を提供します(バイナリには後者のONNX Runtimeモデルが同梱されており、macOSでは追加インストールは不要)。
  • 会話のプレビューリストを表示し、vimスタイルのナビゲーション、ビューア内検索、マークダウンレンダリング、メッセージのコピーやエクスポートが可能な全画面ビューアを開くことができます。
  • UIからセッションを元のエージェントで再開したり、現在のプロジェクトにフォークしたり、名前変更、削除することができます。フォークはgit worktreeをまたいで動作するため、別のリポジトリの会話を現在の作業ディレクトリに引き込むことができます。
  • 付属のClaude Codeスキルにより、Claudeエージェント自身が過去のチャットを検索できます。

重要性 Claude Code、Pi、Oh My Piを使用する開発者は、数十のJSONLトランスクリプトファイルを蓄積することがよくあります。以前の議論を見つけたり、解決策を再利用したり、中断したセッションを続行したりするには、手動でエラーが発生しやすいプロセスが必要です。claude-historyは、そのアーカイブを検索可能なキーボード駆動のインターフェースに変え、エージェントと直接統合し、履歴を開発ワークフローの第一級の部分にします。

主な機能

機能 説明
マルチエージェントサポート Claude Code、Pi、OMP – ソースラベル(CC、Pi、OMP)とともにすべて一覧表示されます。
ファジー+セマンティック検索 プレフィックス、単語境界、フィールド対応の関連性スコアリング、意味を理解するオプションのONNXベースのセマンティックランキング。
会話ビューア 台帳スタイルの表示、マークダウンレンダリング、ツールコールのトグル、思考ブロックのトグル、クリップボードへのコピー、ファイルへのエクスポート。
再開 / フォーク / 名前変更 / 削除 ネイティブのpiまたはomp CLI、またはClaude Codeの再開コマンドを呼び出すワンキーアクション。
worktree対応フィルタリング 著者のworkmuxツールを使用している場合、リストは自動的にアクティブなworktreeに制限されます。
クロスプロジェクトフォーク Ctrl+Fで任意のプロジェクトから現在のディレクトリに会話を引き込みます。
時間フィルタリング --since、--before、--afterで結果を日付範囲または相対期間に制限できます。
クリップボード処理 ローカル、SSH(OSC 52)、tmux内で動作し、CLAUDE_HISTORY_CLIPBOARDで設定可能。
設定可能なUI キーバインディング、デフォルトの再開引数、表示オプションはTOML設定ファイルで設定されます。

インストール

  • クイックスクリプト: curl -fsSL https://raw.githubusercontent.com/raine/claude-history/main/scripts/install.sh | bash
  • Homebrew(macOS/Linux): brew install raine/claude-history/claude-history
  • Cargo: cargo install claude-history
  • プリビルドバイナリはApple Silicon、Intel macOS、x86_64 Linux向けに利用可能です。macOSビルドにはONNXランタイムがバンドルされています。

基本的な使い方

# 任意のプロジェクトディレクトリから
claude-history          # TUIリストを開きます
claude-history <file>   # 特定のJSONLトランスクリプトを直接表示します
claude-history delete-empty   # 空のトランスクリプトファイルを削除します

リスト内:

  • 入力して検索、Ctrl+Rで再開、Ctrl+Fでフォーク、F2で名前変更、Ctrl+Xで削除。
  • Ctrl+Tで語彙的検索とセマンティック検索を切り替えます。
  • ?で完全なショートカットのチートシートを表示します。

設定例(~/.config/claude-history/config.toml)

[search]
mode = "semantic"   # セマンティックモードで開始

[tui]
semantic_search = true   # レガシーキー、まだ動作します

誰が作ったか raineによってメンテナンスされています(avenタスクキューツールの作者と同じ)。リポジトリには、Claudeが自分の履歴を照会できるようにするコンパニオンClaudeスキル(skills/claude-history/SKILL.md)が含まれています。


すべての詳細はリポジトリのREADMEから直接取得されています。追加の機能は推測されていません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト