Copilot Local Usage
Copilot Local Usage is a local-first VS Code extension that parses GitHub Copilot Chat debug logs already present on your machine and turns them into a simple usage view inside VS Code.
It is built for one practical need: seeing how many requests your current machine has generated over time without depending on GitHub's account-wide dashboards.
What you get
- A dedicated Copilot Usage activity view in the VS Code sidebar
- Period summaries for Today, Last 7 days, This month, and Last 30 days
- A recent daily breakdown so you can spot spikes quickly
- A status bar summary for at-a-glance monitoring
- Optional local request and token percentages based on quotas you configure yourself
- A readable Markdown summary report command instead of a raw JSON dump
What is counted
llm_request events from local GitHub.copilot-chat main.jsonl debug logsuser_message events so you can compare prompts with actual LLM requests- Input tokens, output tokens, total tokens, request counts, and prompt counts
What is not counted
- Official GitHub account billing or quotas
- Cross-device totals
- Inline completions in this release
- Any usage that is not present in local VS Code logs on this machine
How it works
The extension scans your local VS Code user storage for GitHub.copilot-chat/debug-logs/*/main.jsonl files, parses structured log events, aggregates them by period, and displays the results locally in the editor.
No external service is required for the local counters themselves.
Privacy
- The extension reads local Copilot Chat log files from your machine.
- It does not need a GitHub API token for its local counters.
- It does not infer data from other PCs.
- It does not provide the official GitHub usage percentage. The displayed percentage is derived only from quotas you set in the extension settings.
See PRIVACY.md for the detailed data handling note included with the project.
Settings
copilotLocalUsage.extraScanPaths: extra local paths to scan. Accepts workspace storage roots, GitHub.copilot-chat/debug-logs folders, or individual main.jsonl files.copilotLocalUsage.monthlyRequestQuota: local request budget used for the month percentage shown by the extension.copilotLocalUsage.monthlyTokenQuota: optional local token budget used for the month token percentage.copilotLocalUsage.maxDailyRows: number of daily rows shown in the recent-days section.copilotLocalUsage.refreshIntervalMinutes: automatic rescan interval. Set 0 to disable background refresh.
Limitations
- Counts depend on what VS Code has kept in local debug logs.
- If logs are cleared, rotated, or disabled, historical totals can shrink.
- This version is focused on Copilot Chat signals that are directly visible in local logs.
Development
npm install
npm run compile
npm run package
Press F5 in VS Code to open an Extension Development Host, use GitHub Copilot Chat locally, then open the Copilot Usage view or run Copilot Local Usage: Refresh.
Disclaimer
This project is not an official GitHub or Microsoft extension. It reads local logs that are already present in VS Code and presents machine-local analytics.
