maniacs.club
← 一覧に戻る
ローカルWebアプリ MIT

claude-code-history-console

Claude Code の会話履歴を、ローカルのWeb UI から検索・書き出し・別PCへ移行する。追加インストールはゼロ(Python 標準ライブラリのみ)。

claude-code-history-console
docs/screenshot.png — 履歴コンソールの画面

機能

全プロジェクト横断の検索

セッションタイトルと本文を全文検索し、一致箇所をハイライト。プロジェクト絞り込みと並び替えにも対応。

ワンクリックのエクスポート

サブエージェントの記録や memory/ を含む完全なプロジェクトデータを ZIP で書き出します。

別PCへのインポート

パスの再エンコードを自動で行うので、移行先でもそのまま /resume できます。

孤立履歴の検出

削除・移動済みのプロジェクトの履歴を状態つきで一覧し、安全に整理できます。

フォルダ移動の追従

プロジェクトを別の場所に移しても、履歴をコピーして resume を継続できます(元は残す)。

単体ビューアの書き出し

build_viewer.py で全データを埋め込んだ viewer.html を1枚生成。サーバー不要・オフラインで閲覧できます。

インストール

Python 3.8 以上があれば pip install は不要です。Windows は start_console.bat、macOS は start_console.command をダブルクリックしても起動できます。

python serve.py            # http://127.0.0.1:8765/
python serve.py --port 9000 --no-open

python build_viewer.py     # 単体の viewer.html を生成

技術スタック

Python 3.8+ 標準ライブラリのみ HTTP JSON API Windows / macOS / Linux

対応状況と制限

安全性サーバーは 127.0.0.1 のみにバインド。ループバック Host ヘッダの検証と POST の発行元チェックで CSRF / DNS リバインドを防ぎます。
削除ブラウザ側の明示確認に加え、対象が ~/.claude/projects/ 配下かをサーバー側でも検証します。
インポートパストラバーサルと Zip Slip に対策済み。移行操作はすべてコピーベースで、元データは残ります。
既知の制限OS をまたぐ移行はパスの前置き置換のみで、区切り文字やドライブ表記は変換しません。viewer.html は読み取り専用です。
注意非公式のコミュニティツールで、Anthropic とは関係ありません。

ほかのアプリ