VS Code 拡張機能¶

Chronicle 拡張機能は、VS Code のエクスプローラーに 2 つのセクションを追加し、ファイルの背後にあるコーディングエージェントのセッションを表示します。「このコードはなぜこうなっているのか」がワンクリックでわかります。書いたセッション、その要約と結果、ダッシュボードでの全文の記録です。

拡張機能の名前は Chronicle のままですが、Interlatch でそのまま使えます。セクションと設定も Chronicle と chronicle.* の名前のままです。

Chronicle: This File は、開いているファイルを読んだり変更したりしたセッションを新しい順に表示します。アクティブなエディターに追従し、VS Code のウィンドウごとにそれぞれのファイルを表示します。
Chronicle: Files in Workspace は、開いているフォルダーの中でセッションが読んだり変更したりしたファイルを、エクスプローラーと同じようなフォルダーツリーで表示します。フォルダーとファイルごとに、触れたセッションの数と時期が表示されます。ファイルを展開するとそのセッションが表示され、横の Open File ボタンでファイルが開きます。もう存在しないファイルと、git が無視するファイルは表示しません。

新しいセクションはエクスプローラーの一番下に、折りたたまれた状態で追加されます。セクションの見出しをドラッグすると移動でき、見出しを右クリックするとセクションの表示・非表示を切り替えられます。配置は VS Code が記憶します。

各セッションの行には、タイトルと、実行してからの時間が表示されます。展開すると詳細が 1 行ずつ表示されるので、狭いサイドバーでも読めます。日時、エージェントとプロジェクト、ブランチ、ファイルに対して行ったこと（+12 −3 lines、 edited 2×、read 4×）、結果、要約です。詳細の最後の Open in Chronicle、または行のボタンで、ダッシュボードでそのセッションが開きます。

データは、すでに動いているダッシュボード（interlatch ui、または interlatch install が設定するバックグラウンドサービス）から http://127.0.0.1:11524（以前のインストールでは :8765）経由で読み込みます。ほかの場所には何も送らず、アカウントも不要です。

インストール¶

拡張機能はまだ Marketplace にありません。リポジトリからビルドして、ファイルをインストールします。

cd vscode-extension
npx @vscode/vsce package          # chronicle-sessions-0.2.0.vsix を作成
code --install-extension chronicle-sessions-0.2.0.vsix

一覧が読み込む /api/file と /api/files エンドポイントは、Interlatch と 0.6.1 より新しい Chronicle にあります。古いバージョンでは、一覧にアップデートするよう表示されます。

設定¶

設定	既定値	内容
`chronicle.url`	空：`http://127.0.0.1:11524`、なければ `:8765`	ダッシュボードのアドレス。Interlatch の設定で `[server] port` を変えた場合は合わせて変更します。
`chronicle.includeReads`	`true`	読んだだけのセッションとファイルも表示します。オフにすると、セッションが変更したものだけになります。
`chronicle.showIgnoredFiles`	`false`	git が無視するファイル（スクリーンショット、ビルド出力、キャッシュ）も Chronicle: Files in Workspace に表示します。

見つかるもの、見つからないもの¶

ファイルは絶対パスで照合し、パスをセッションのフォルダーからの相対パスで記録するエージェント（Codex がそうすることがあります）についてはその相対パスでも照合します。そのため、次のものは見つかりません。

別の git worktree や古いクローンにある同じファイル。 ../myapp-feature で動いたセッションが記録したのは ../myapp-feature/src/app.py で、myapp/src/app.py とは別のパスです。
リモートウィンドウのファイル（SSH、コンテナー、WSL）。一覧には、Chronicle はこのコンピューター上のファイルしかわからないと表示されます。
まだ同期されていないセッション。 Claude Code のセッションは終わったときに、Codex、Copilot、Bob、Antigravity のセッションは 15 分ごとに取り込まれます（ソース）。

エンドポイント¶

GET /api/file?path=<絶対パス>&limit=50 は {"path", "total", "sessions"} を返します。各セッションには /api/sessions と同じ項目に加えて、このファイルについての file: {reads, changes, added, removed} が含まれます。ダッシュボードに届くものなら、スクリプトでもほかのエディターでも使えます。

GET /api/files?root=<絶対パスのフォルダー>&limit=200&existing=1&ignored=0 は {"root", "total", "files"} を返します。そのフォルダーの中でセッションが読んだり変更したりしたファイルを、最近触れた順に並べたものです。各ファイルには path、rel（root からの相対パス）、sessions、changed（そのうち変更したセッションの数）、last、そして数の元になる ID（session_ids、changed_ids）が含まれます。existing=1 を付けるともう存在しないファイルを、ignored=0 を付けると git が無視するファイルを除きます。