Chronicle

実行したすべてのコーディングエージェントのセッションを、検索できる記憶に。
Claude Code、Codex、GitHub Copilot、IBM Bob のセッションと claude.ai・ChatGPT のチャットを、自分のマシンの中で保存し、ナレッジに変えます。

クイックスタート · ドキュメント · 変更履歴 · English

コーディングエージェントは一日中問題を解決しますが、その教訓はすぐに消えてしまいます。Claude Code はトランスクリプトを 30 日で削除し、あるセッションで見つけた修正が次のセッションに引き継がれることもありません。Chronicle はすべてのセッションを保存し、Claude Code または Codex を使って学んだことを取り出し、ダッシュボードであなたに、MCP サーバー経由でエージェントに返します。

Chronicle のセッションページ：1 行にまとまったツール呼び出しを含む会話、そこから抽出したナレッジ、プロンプトのアウトライン

何が得られるか¶

Chronicle は終わったセッションを読み、残す価値のあることを書き留めます。以下はデモデータからそのまま取り出した実例です（デモデータは英語です）。

Gotcha · billing-api
Stripe webhook signatures need the raw request body
Webhook.construct_event verifies the signature over the exact bytes Stripe sent. Parsing to JSON first, or posting json= in tests, fails with SignatureVerificationError. Read await request.body() and pass that.
_{セッション「Stop double charges when Stripe retries invoice.paid」から自動で抽出。}

すべてのセッションを残す。 元のトランスクリプトを保管するので、エージェントが片付けても何も失われません。
ナレッジを自動で抽出。 修正、落とし穴、決定、コマンド、プロジェクトの事実、好みを、プロジェクトごとのナレッジベースと、全プロジェクト共通のプレイブックにまとめます。
エージェントから質問できる。 MCP サーバー経由で、エージェントが過去のセッションを検索できます。例：「このエラー、前にも出た？」「なぜ冪等性を Postgres でやることにしたんだっけ？」Claude Desktop、Cursor、Windsurf、 Gemini CLI からも接続できます。
すべてを眺めるダッシュボード。 トランスクリプト全体を含むセッション、統計、自分の用語をマインドマップにした用語集、ひと目でわかる週次の振り返り。⌘K でどこへでも移動できます。
ただのファイルとしても。 Obsidian 互換の Markdown 保管庫と chronicle CLI。

クイックスタート¶

macOS 13 以降と、ログイン済みの Claude Code または Codex （分析を担当）が必要です。

インストール。

uv tool install --python 3.13 agents-chronicle   # または: pipx install agents-chronicle
chronicle install

chronicle install は Mac にあるコーディングエージェントを見つけ、どれを記録するか尋ね、過去のセッションを取り込み、ログイン時から Chronicle を動かすかを尋ねます。アプリがよければ最新リリース（Apple シリコン）からダウンロードして Connect を選びます。

いつも通りエージェントを使う。 各セッションは終了時に記録され、バックグラウンドで分析されます。
眺める。 ダッシュボード http://127.0.0.1:8765/（または chronicle ui --open）を開いて ⌘K を押すか、エージェントに「先週何を学んだ？」と聞きます。

エージェントはあとから Settings › Sources、chronicle connect <agent>、または chronicle install の再実行で追加できます。各ステップが何を設定するか、削除の仕方はインストールにあります。

対応エージェント¶

エージェント	記録元	取り込み	エージェントからの検索（MCP）
Claude Code	`~/.claude/projects` のトランスクリプト	セッション終了ごと、および 15 分ごと	✅
Codex	`~/.codex/sessions` のロールアウト	15 分ごと（アイドルになってから）	✅
Codex Cloud	chatgpt.com/codex のタスク（`codex` CLI 経由。タイトル、リポジトリ、差分）	15 分ごと	Codex 経由
GitHub Copilot	Copilot CLI とエージェントのセッション、VS Code の Copilot Chat ログ	15 分ごと	✅ VS Code と Copilot CLI
IBM Bob	`~/.bob/db/bob.db`（読み取り専用）	15 分ごと	✅
claude.ai、ChatGPT	データエクスポート：`chronicle import <zip>`	取り込んだとき	–

すべて同じダッシュボード、ナレッジ、用語集、MCP ツールを共有します。分析は Claude Code と Codex のうち、選んだほうで行います。詳しくはソースを参照してください。

もう少し詳しく¶



ホーム。稼働時間、セッション、トークン、推定コストを日ごとに。	マップ。用語集をマインドマップに。各用語から、その背後のナレッジとセッションへ。	⌘K。セッション、ナレッジ、プロジェクト、用語、コマンドをひとつの検索で。

スクリーンショットは架空のデモデータです。

仕組み¶

Chronicle の仕組み：ソース、アーカイブ、解析、SQLite、claude -p または codex exec による分析、ナレッジ、そしてダッシュボード・保管庫・CLI・MCP サーバー

フック（または 15 分ごとの同期）が終わったセッションを Chronicle に渡し、Chronicle は元のトランスクリプトを保管して解析します：プロンプト、応答、ツール呼び出し、ファイル、トークン、コスト。
セッションがアイドルになると、秘密情報を伏せた要約版のダイジェストが、選んだほうの Claude Code（claude -p）または Codex（codex exec）に送られ、要約とナレッジ項目が返ってきます。この呼び出しはサンドボックス内で動き、ツール、フック、 MCP サーバーは使いません。
新しいナレッジはプロジェクトのナレッジベースにまとめられ、用語集が更新され、終わった週ごとに振り返りが書かれます。
すべてがあなた（ダッシュボード、アプリ、保管庫、CLI）とエージェント（MCP）に提供されます。

マシンの外に出るもの： その伏せ字済みのダイジェストだけで、あなた自身の Claude Code または Codex のログインを通じて Anthropic または OpenAI に送られます。テレメトリはなく、ほかの誰にも何も送りません。何がどこに保存されるかはデータとプライバシーにあります。

費用： 分析は、そのエージェントのほかの利用と同じように Claude または ChatGPT のプランから使われます。Claude の場合、 API 換算では Sonnet で 1 セッションあたり平均約 $0.38 です。chronicle analyze --pending --dry-run で、使う前にたまった分の規模を確認できます。詳しくは分析の仕組みを参照してください。

よくある質問¶

エージェントが遅くならない？ なりません。セッション終了フックは切り離したプロセスに処理を渡し、数ミリ秒で戻ります。分析はあとでバックグラウンドで行います。

Claude Code は必須？ いいえ。分析は Claude Code と Codex のどちらでも行えます。Status › Analysis または chronicle config set analysis.backend codex で選びます。記録と閲覧はどちらでも使えます。どちらにもログインしていない場合、セッションは保管され、分析待ちの列で待ちます。

Windows や Linux は？ まだです。アプリとバックグラウンドのエージェントは macOS 専用です。

特定のプロジェクトやセッションを除外できる？ 設定の sources.exclude_projects にプロジェクトを追加するか、chronicle forget <id> でセッションを完全に削除します。

削除するには？ chronicle uninstall でフック、バックグラウンドのエージェント、MCP の登録を削除します（データは残ります）。データも消すには --purge を付けます。

うまく動かないときはトラブルシューティングを参照してください。

ドキュメント¶

インストール · ソース · ダッシュボード・用語集・マップ · コマンドライン · MCP サーバー · 記録内容と分析の仕組み · 設定 · データとプライバシー · トラブルシューティング · 開発

コントリビュート¶

Issue やプルリクエストを歓迎します。テストの実行方法や、自分のセッションの代わりにデモデータでダッシュボードを開発する方法は CONTRIBUTING.md にあります。

ライセンス¶

MIT