winget install --id=Kukisama.gh-usage -e A fast Rust CLI that scans local GitHub Copilot usage records from VS Code and Copilot CLI, summarizes credit usage, and exports detailed CSV or JSON reports.
gh-usage is a small command-line tool that scans local GitHub Copilot / Copilot Chat records and exports credit usage details.
It is intended for local inspection only. The result is based on records available on the current machine and is not a replacement for GitHub billing or official usage reports.
GitHub Copilot usage data can be useful for local review, troubleshooting, and rough usage analysis. This tool helps answer basic questions such as:
Build the optimized release binary:
.\scripts\build-release.ps1
Or use Cargo directly on any supported platform:
cargo build --release -p gh-usage
The binary is generated under:
target/release/
The repository includes a GitHub Actions release workflow at .github/workflows/release.yml.
To publish a new release, update the version field in Cargo.toml and push that commit to main or master. The workflow will:
v.Release assets include:
gh-usage-v-windows-.zip: Windows executable with README and licensegh-usage-v-linux-.zip: Linux executable with README and licensegh-usage-v-macos-.zip: macOS executable with README and licensegh-usage-v-source.zip: source archive for the released commitgh-usage-v-checksums.txt: SHA256 checksumsYou can also publish by pushing a tag such as v0.1.0, or by running the workflow manually from GitHub Actions.
Run without arguments:
.\target\release\gh-usage.exe
On Linux or macOS, run:
./target/release/gh-usage
By default, the tool:
copilot-usage.csv in the current directory.You can also double-click the release executable on Windows. In that case, the tool keeps the console window open at the end so you can read the message before closing it.
GitHub Copilot usage summary
output=copilot-usage.csv
records=101
total_credits=16679.800
active_days=2
avg_credits_per_active_day=8339.900
daily_credits:
2026-05-17 records=25 credits=5558.600
2026-05-18 records=76 credits=11121.200
scan_stats:
scanned_files=774
scanned_lines=73660
candidate_lines=179
parse_errors=0
timing_ms:
discover_ms=11
scan_ms=2074
reduce_ms=0
write_ms=0
total_ms=2087
Show help:
.\target\release\gh-usage.exe --help
Write CSV to a custom path:
.\target\release\gh-usage.exe --output .\target\gh-usage.csv --summary
Scan only files modified in the last 7 days:
.\target\release\gh-usage.exe --since-days 7 --output .\target\gh-usage-last-7-days.csv --summary
Include GitHub Copilot CLI logs:
.\target\release\gh-usage.exe --include-cli-logs --output .\target\gh-usage-with-cli.csv --summary
Export JSON:
.\target\release\gh-usage.exe --format json --output .\target\gh-usage.json --summary
Measure runtime in PowerShell:
Measure-Command { .\target\release\gh-usage.exe --output .\target\gh-usage.csv --summary }
The CSV contains one row per extracted usage record. Important fields include:
local_time_hint: local timestamp when availablechat_title: chat title when availablemodel: model name parsed from the recordmodel_id: model identifier when availablecredits: credits consumed by the recorddetails: raw credit detail textfile: source file scannedline: source line numberCSV files include a UTF-8 BOM by default for better compatibility with Windows Excel. Use --no-bom to disable it.
workspaceStorage location for the current OS.