Copilot Insight

🇬🇧 English | 🇯🇵 日本語

English

A 100% local, privacy-first VS Code extension that parses GitHub Copilot's local log files and visualizes your usage statistics in a blazingly fast, reactive dashboard.

Explore recorded Copilot activity, token usage, and session history from local logs.

🚀 Key Features

• 100% Local & Privacy-First — No telemetry, no cloud servers. It parses local VS Code extension host logs and Copilot CLI session records on your machine.
• Completion counts — Shows recorded inline suggestions and acceptances when available.
• Inline data limits — Suggestion counts depend on local logs and can be incomplete. VS Code does not expose another extension's live Copilot completion events.
• Exported rates — CSV leaves acceptance rates empty when no suggestions were shown. JSON retains its numeric summary.acceptanceRate for compatibility and includes summary.acceptanceRateAvailable to indicate whether that value can be used.
• Model usage — Shows recorded chat and inline completion counts, token usage by model, and finish reasons when the local logs provide them. These observations do not identify the best model or measure output quality.
• Copilot CLI Usage — Shows input/output and cached token totals, AI credits, and daily/model breakdowns from local CLI session records. VS Code Chat credits are not included in this CLI total.
• Daily Consumption & Thread Costs — Overview charts show AI credits and input/output tokens by model-call date (UTC), with 7-day, 30-day, and full-history views. Sessions includes CLI/SDK conversation totals and per-prompt consumption alongside editor threads.
• Activity & Flow — Activity heatmaps by hour of the day and weekly trend comparisons.
• MCP Server Built-in — Exposes get_usage_summary, get_model_efficiency, and get_anomaly_report tools via the Model Context Protocol, allowing external AI agents (like Claude Desktop) to query your stats locally.

🛠️ Under the Hood (Architecture)

Copilot Insight is built for extreme performance without bloating your editor:

• Backend (Rust + NAPI-RS): The log parsing engine is entirely written in Rust. It performs zero-copy, OS-level file I/O to parse massive log files instantly, bypassing Node.js memory limits.
• Frontend (Lit): The dashboard UI is built with the Lit framework, using lightweight, reactive Web Components that render smoothly without the overhead of heavy SPA frameworks.
• Analytics: A local in-memory event store supports session history and named analytics queries.

🗂️ Dashboard Tabs

• 📊 Overview: Summary cards, recorded agent activity, auto-generated insights, and weekly trends.
• 🔍 Health (Diagnostics): Activity and acceptance-rate timelines, daily usage, and model breakdowns. CLI / SDK prompt counts are shown separately from accepted inline suggestions.
• 🌊 Activity by Hour: Inline and chat activity heatmaps.
• 💬 Prompt Insights: Tag Cloud of frequent terms, Intent Command donut, prompt length versus observed response rate, and saved chat sessions by request count. A recorded response is not a measure of acceptance, quality, or task completion.
• 📂 Sessions: Session Intelligence Explorer. Drill down into chat threads, user prompts, file edits, and memory refreshes.

How to Use

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run Copilot Insight: Show Usage
3. The usage dashboard panel opens automatically.

Alternatively, click the Copilot Insight icon in the Activity Bar on the left side of VS Code.

Token and AI credit consumption

• Open Overview → Daily token and AI credit consumption for the daily graphs and the expandable data table. Periods end on the latest recorded day; only locally recorded model calls are shown.
• Select View thread totals or open Sessions, then select a Copilot CLI / SDK thread. Its header shows the conversation total; each prompt shows the calls recorded before the next prompt. Previews stay local and are limited to 160 characters.
• Cumulative checkpoints can include adjustments (for example Fusion accounting) without a call timestamp or prompt association. These remain in the thread total; differences from the daily graphs are shown separately, never assigned to the session start date. New calls after a checkpoint are included.
• Cached input is already part of input tokens. Missing credit data is Unavailable, not zero. Credits are Copilot usage units, not a currency bill; other devices and unrecorded VS Code Chat usage are not covered. Use Copilot Insight: Refresh to read newly appended records. Existing snapshots without thread details require a refresh.
• The same view shows observed model-call timing across the recorded history and separates human permission responses from host policy decisions. Sessions show recorded context compactions and subagent relationships. Timing comparisons do not control for task differences; unavailable fields are not inferred. Agent-origin messages are shown separately from human prompts. Refresh older snapshots to populate these details.

Metric and export changes in 1.1.14

The dashboard and Markdown reports no longer estimate developer time saved, ROI, true acceptance, or agent thinking depth and planning success. Legacy VS Code completion counts are shown only when recorded; CLI token and AI credit usage comes from local session records. Existing event history is retained.

The MCP get_usage_summary response no longer includes estimatedMinutesSaved; totalCharsAccepted sums recorded characters without filling in missing values. Historical Markdown reports generated after updating also omit the removed metrics.

Configuration

Installing from VSIX (local build)

1. Build the extension package: npm run package
2. Install the generated VSIX file in VS Code via Command Palette (Extensions: Install from VSIX...) or CLI: code --install-extension copilot-insight-<version>.vsix

Building the Native Rust Parser

The extension ships with a fast JS fallback, but compiling the Rust native addon unlocks maximum performance.

# 1. Build the native addon (outputs a .node file via NAPI-RS)
npm run build:native

# 2. Run the Rust unit tests
cd native-parser && cargo test

Restart the VS Code extension host (Developer: Reload Window) to apply.

Integration tests

Run npm test for the VS Code integration suite. To build and install a VSIX in an isolated profile and test the dashboard, set VSCODE_EXECUTABLE_PATH to the VS Code executable and run npm run test:vsix. This smoke test requires Rust and a graphical display; on Linux it can run under xvfb-run -a.

日本語

インライン補完の件数はローカルログに記録された範囲に限られます。VS Code は他の拡張機能の Copilot 補完イベントをリアルタイムに公開していません。

表示件数がゼロの場合、CSV の採用率は空欄です。JSON は互換性のため数値を保持し、summary.acceptanceRateAvailable で率を算出できるかを示します。

GitHub Copilot のローカルログファイルを解析し、使用統計を高速かつリアクティブなダッシュボードで可視化する、100%ローカル・プライバシーファーストな VS Code 拡張機能です。

ローカルログに記録された Copilot の利用状況、トークン使用量、セッション履歴を確認できます。

🚀 主な機能

• 100% ローカル & プライバシーファースト — 外部サーバーへのテレメトリ送信は一切ありません。マシン上の VS Code ログと Copilot CLI のセッション記録を解析します。
• 補完件数 — 記録がある場合にインライン補完の表示件数と採用件数を表示します。
• モデル別使用量 — ローカルログに記録されたチャット・インライン補完の件数、モデル別トークン使用量、終了理由を表示します。これらの記録から最適なモデルや出力品質は判定できません。
• Copilot CLI 使用量 — ローカルセッション記録から入力・出力・キャッシュトークン、AIクレジット、日別・モデル別の内訳を表示します。このCLI集計にはVS Code Chatのクレジットは含まれません。
• 日別消費グラフとスレッド別費用 — Overviewで呼び出し日時（UTC）に基づくAIクレジット・入力／出力トークンを7日・30日・全履歴で表示。SessionsではCLI/SDKスレッド全体の累計と、プロンプトごとの消費量を確認できます。
• アクティビティ — 時間帯別のヒートマップと週次トレンドを表示します。
• MCP サーバー内蔵 — Model Context Protocol サーバーを内蔵しており、Claude Desktop などの外部AIエージェントが、ローカルであなたの使用統計（get_usage_summary 等）を直接照会できます。

🛠️ アーキテクチャ (Under the Hood)

エディタの動作を重くすることなく、極限のパフォーマンスを引き出すために設計されています：

• バックエンド (Rust + NAPI-RS): ログ解析エンジンはすべてRustで書かれています。Node.jsのメモリ制限を回避し、OSレベルでのゼロコピー・ファイルI/Oにより、巨大なログファイルを瞬時に解析します。
• フロントエンド (Lit): ダッシュボードUIは Lit フレームワークで構築されています。重いSPAフレームワークのオーバーヘッドなしに、軽量でリアクティブな Web Components として高速にレンダリングされます。
• 分析: ローカルのインメモリーイベントストアでセッション履歴と定義済みの分析クエリを扱います。

🗂️ ダッシュボードタブ構成

• 📊 Overview: サマリーカード、自動生成Insights、週次トレンド。
• 🔍 Health (Diagnostics): アクティビティタイムライン、日次使用状況、モデル別内訳。
• 🌊 Activity by Hour: 補完とチャットの時間帯別ヒートマップ。
• 💬 Prompt Insights: 頻出用語、プロンプト長と記録された応答率、チャットの依頼数分布。応答の記録は採用・品質・タスク完了を意味しません。
• 📂 Sessions: Session Intelligence Explorer。チャットスレッド、ユーザープロンプト、ファイル編集のタイムラインをドリルダウン解析。

使い方

1. コマンドパレットを開きます (Ctrl+Shift+P / Cmd+Shift+P)
2. Copilot Insight: Show Usage を実行します
3. 使用状況ダッシュボードのパネルが自動的に開きます。

（または、アクティビティバーの Copilot Insight アイコンをクリック）

トークン・AIクレジットの確認

• Overview → Daily token and AI credit consumptionで日別グラフと数値表を確認できます。期間の終点は最新の記録日で、日付はUTCです。
• View thread totalsまたはSessionsから Copilot CLI / SDK のスレッドを選択すると、スレッド累計と各プロンプトから次のプロンプトまでの呼び出し消費量を表示します。プロンプトのプレビューは160文字までで、ローカルにのみ保持します。
• Fusionなどの累計補正や日時不明の利用量は、開始日に押し込まずスレッド累計に含め、日別グラフとの差分を別表示します。キャッシュ分を入力トークンに重ねて加算することはありません。
• 費用を取得できない場合は0ではなく Unavailable（未取得） と表示します。AIクレジットは利用単位で、請求確定額ではありません。他端末や未記録のVS Code Chat利用は対象外です。最新ログの反映・古い保存データの更新には Copilot Insight: Refresh を実行してください。

1.1.14 の指標と出力の変更

ダッシュボードと Markdown レポートから、節約時間・ROI・True Acceptance や、思考の深さ・計画成功率の推定を削除しました。旧 VS Code ログ由来の補完件数は記録がある場合に表示し、CLI のトークンと AI クレジットはローカルのセッション記録から集計します。既存のイベント履歴は保持されます。

MCP の get_usage_summary は estimatedMinutesSaved を返さず、totalCharsAccepted は記録された文字数のみを合計します。更新後に過去の履歴から生成する Markdown レポートにも、削除した指標は含まれません。

設定

VSIX からのインストール (ローカルビルド)

1. パッケージをビルドします: npm run package
2. コマンドパレット (Extensions: Install from VSIX...) または CLI からインストール: code --install-extension copilot-insight-<version>.vsix

ネイティブ Rust パーサーのビルド

JSのフォールバックパーサーでも動作しますが、Rustネイティブアドオンをコンパイルすることで最大のパフォーマンスが解放されます。

# 1. ネイティブアドオンをビルド (NAPI-RS経由で .node ファイルを出力)
npm run build:native

# 2. Rust ユニットテストを実行
cd native-parser && cargo test

適用するには VS Code ウィンドウを再読み込み (Developer: Reload Window) してください。

結合テスト

npm test で VS Code の結合テストを実行します。VSIX をビルドして隔離プロファイルにインストールし、ダッシュボードを検証するには、VSCODE_EXECUTABLE_PATH に VS Code の実行ファイルを指定して npm run test:vsix を実行します。Rust と画面表示環境が必要です。Linux では xvfb-run -a を利用できます。