クイックスタート

Chronicle をインストールし、最初のタイムトラベル——メッセージをクリックすると、その瞬間の見た目どおりにコードが巻き戻る様子を眺めること——におよそ 5 分でたどり着きます。

Chronicle の核となる仕掛けは、体験するのは簡単でありながら忘れがたいものです。AI コーディングセッション内のすべてのメッセージを Git 履歴と突き合わせるため、会話上の任意の地点が、コードの正確な状態をのぞく窓になります。ループ全体は、ほんの数秒でこうなります。

Chronicle — Playback● LIVE

User

Assistant

Tool Call

User

Assistant

server/git.js

1export function commitAt(dir, ts) {

2 // TODO: pick a commit

2 const hash = git(dir, ['rev-list', '-1']);

3 return describeCommit(dir, hash);

4}

5 

6function treeAt(dir, commit) {

セッション内の任意のメッセージをクリックその瞬間の正確なコード状態に巻き戻します差分に切り替えて変更点を確認動画のようにタイムラインをスクラブ

アカウントも API キーもネットワークも不要——Chronicle は、AI ツールがすでにディスクに書き出したログを、完全にあなたのマシン上で読み取ります。

1 · インストール

macOS — ダウンロード: getchronicle.dev からアプリを入手します。ボタン 1 つで、Apple Silicon か Intel かを自動判別します。ビルドは署名・公証済みなので、Gatekeeper の警告なしに開けます。

macOS — Homebrew:

brew tap chizhangucb/chronicle
brew install --cask chronicle

ソースからの実行（任意のプラットフォーム——Windows/Linux インストーラーはまだビルドされていません）:

npm install
npm run dev        # dev server → http://localhost:4173

インストール後、Chronicle は自身を最新に保ちます——新しい署名済みリリースはバックグラウンドでダウンロードされ、ワンクリックの Relaunch to update を提示します。実行モード、要件、詳細についてはインストールを参照してください。

2 · Git 管理下のプロジェクトを選ぶ

Chronicle は Git コミットを通じてタイムトラベルするため、プロジェクトがある程度の履歴を持つ Git リポジトリであるセッションを選びましょう。コミットが多いほど、Chronicle はメッセージ間のコードをより正確に再構築できます。リポジトリがないプロジェクトでも会話は再生されますが、コードスナップショットのペインは得られません。

3 · セッションを取り込む

1. Chronicle を起動します（または npm run dev → http://localhost:4173）。プロジェクトのホーム画面に着きます——初回起動時は空です。
2. + Import Sessions をクリックします。Chronicle は、サポートされている 6 つのツールすべての標準的なログの場所をスキャンし、見つかったものを表示します。ソースを選びましょう——手元にあるなら Claude Code が最も情報豊富です。
3. ウィザードは、NEW / Partial / Imported のバッジ付きでセッションを一覧します（新しいものはあらかじめ選択されています）。Start Import を押します——読み取り専用なので、元のログには決して触れません。

セッションの取り込みでは、フロー全体と 6 つのツールすべてを扱っています。

4 · タイムトラベル

1. ホーム画面に戻り、プロジェクトカードをクリックしてから、任意のセッションをクリックします。
2. セッションは Overview で開きます。左のレールから Playback に切り替えます（または ⌘2 を押します）。
3. 任意のメッセージをクリックします。中央のペインが、直前の最も近いコミットに解決して、その瞬間の状態どおりにファイルツリーとファイル内容を再構築します。変更されたファイルには緑のドットが付き、自動的に選択されます。差分を見るには D を押します。
4. TimberLine（下部）に沿ってドラッグすれば、セッション全体をスクラブして、コミットごとにコードが変化していく様子を眺められます。

これが「なるほど！」の瞬間です。タイムトラベルでは、いま見ているものすべてを解説しています。

ローカルファースト: すべてのステップが完全にあなたのマシン上で実行されました。Chronicle は LLM の呼び出しもクラウドへのリクエストも行っていません——ローカルのログをローカルの SQLite データベースへ解析し、あなた自身の Git 履歴からコードを再構築しました。セッションを閲覧することについて、ノートパソコンから外へ出るものは何もありません。

次に読むもの

• ソースが見当たらない、あるいはバッジの意味を理解したい？ → セッションの取り込み
• 再生 / 差分 / タイムラインの完全なリファレンス → タイムトラベル
• Overview タブが教えてくれること（コスト、アクティブ時間、コンテキスト） → セッションインサイト

関連

• インストール — 実行モード、要件、自動アップデートの詳細。
• セッションの取り込み — 取り込みウィザード、6 つのツール、読み取り専用の保証。
• タイムトラベル — 再生モード、スナップショット、差分、TimberLine の詳細。