Chronicle ドキュメント
Chronicle は、AI コーディングセッションのためのローカルファースト（local-first）なタイムマシンです。 AI コーディングアシスタントがすでに書き出している会話ログを取り込み、各メッセージを、その瞬間のコードの正確な状態に対応付けます。この状態は、プロジェクトの Git 履歴から再構築されます。任意のメッセージをクリックすれば、当時のコードへとさかのぼれます。
すべては手元のマシン上で動作します。LLM の呼び出しはどこにも存在せず、クラウドのバックエンドもなく、元のログやプロジェクトのリポジトリに書き込むことも一切ありません。Chronicle は AI ツールを観測して整理するだけで、それらを置き換えることはありません。
Chronicle は現在、6 つのツール——Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilot Chat——から取り込み、それらのセッションを、パスを基準とした単一のプロジェクトビューに統合します。
はじめての方へ クイックスタートへ進めば、5 分以内に最初のタイムトラベル体験にたどり着けます。
3 つの柱
Chronicle の設計思想は Replay（再生）· Control（制御）· Secure（保護） です。
- Replay（再生） — 任意のセッションを対象としたタイムトラベル、決定論的なReplay サンドボックス、セッションをドキュメントや再利用可能なプロンプトへ蒸留するRefine、そして AI が読んだ内容と変更した内容を結びつけるコンテキスト因果関係。
- Control（制御） — すべてのツールにまたがる MCP サービスと Skills のための統合コントロールプレーン。既存の設定を引き継ぎ、一元化し、あらゆる場所へ配布します。
- Secure（保護） — ワンクリックのセキュリティチェックと秘匿化（redaction）、リアルタイムのツール実行前インターセプト、そしてローカルで提供される秘匿化済みの共有リンク。解析と保存はすべてデバイス上に留まります（プライバシーとデータを参照）。
ガイド
セットアップして動かし、各機能を順に見ていきましょう。
| ページ | 内容 |
|---|---|
| インストール | Homebrew、署名済み DMG、ソースからの実行、自動アップデート |
| クイックスタート | 5 分以内で体験する最初のタイムトラベル |
| セッションの取り込み | 取り込みウィザード、6 つのソースすべて、読み取り専用の保証 |
| タイムトラベル | 再生モード、コードスナップショット、差分ビュー、TimberLine タイムライン |
| 検索とフィルタリング | 種類フィルターのチップ、⌘F 検索、⌘K コマンドパレット |
| セッションインサイト | 概要統計、アクティブ時間、コストと使用量、コンテキストウィンドウのバー |
| Refine モード | Keep / Delete / Edit / Insert でセッションを蒸留してエクスポート |
| Replay モード | 隔離されたサンドボックス内での決定論的な再実行 |
| プロジェクト管理 | 論理プロジェクト、関連付け、Git ピル、同期 |
| コンテキスト因果関係 | 信頼度ティア付きのヒューリスティックな読み取り → 変更のリンク付け |
| ライブストリーミング | 進行中のセッションをリアルタイムで観察 |
| MCP Hub | 集約型 MCP サーバー、設定の引き継ぎ、ツールポリシー、Inspector |
| Skills Hub | スキルの中央保管、シンボリックリンクによる配布、GitHub 取り込み、バージョン管理 |
| セキュリティと共有 | セキュリティチェック、カスタムルール、ツール実行前フック、共有リンク |
リファレンス
| ページ | 内容 |
|---|---|
| キーボードショートカット | モード別にまとめたすべてのショートカット |
| 互換性 | 6 ツールのサポート状況の一覧と、ツールごとのログの場所 |
| 設定 | ~/.chronicle/ の構成、環境変数、config.json |
| プライバシーとデータ | ローカルファーストの保証と、正確な送信リクエストの一覧 |
アーキテクチャ
コードベースを理解し、拡張したいコントリビューター向けです。
| ページ | 内容 |
|---|---|
| 概要 | 単一プロセス／単一ポートの設計、実行モード、コンポーネントマップ、原則 |
| データモデル | SQLite スキーマ、正規化されたイベントモデル、replaceSession |
| パーサーと取り込み | イベントモデルの詳細と、新しいソースの追加方法 |
| Git スナップショットエンジン | Git 履歴からのコード状態の再構築 |
| MCP と Skills の内部構造 | レジストリ、ハブ、Streamable HTTP、スキルの配布 |
| セキュリティ・ライブ・リプレイ | 秘匿化エンジン、SSE ウォッチャー、リプレイエンジン、因果関係 |
| API リファレンス | すべての REST ルート、SSE ストリーム、/mcp、/share |
| デスクトップとパッケージング | Electron シェル、署名、自動アップデート、リリースフロー |
その後、開発環境のセットアップ、ブランチと PR のワークフロー、変更の検証方法についてはコントリビューションを参照してください。
プロジェクトの背景
Chronicle は、詳細なプロダクト要求仕様書に基づいて構築されました。その意思決定ログには、実際に出荷されたものと見送られたものが記録されています。README には全機能の一覧があり、CHANGELOG はリリースを追跡しています。
ライセンス: Chronicle は MIT ライセンスで提供されています。