GitHub Copilot Usage Metrics Viewer
Visualize GitHub Copilot usage metrics from your organization. Upload metrics NDJSON files to analyze user engagement, feature usage, and adoption patterns.
Features
- Upload and parse GitHub Copilot metrics NDJSON files
- Executive summary with key adoption metrics
- User breakdowns: unique users, chat users, agent users, CLI users, completion-only users
- Interactive charts for usage patterns and trends
- Drill down into individual user activity with feature adoption radar charts
- Model usage analysis
- CLI adoption trends, sessions, and token usage
- IDE, CLI, and Copilot App productivity-proxy comparison
- IDE and VS Code extension version analysis
- Statistics by programming language and Copilot feature
- Responsive layout, deployable as a static site to GitHub Pages
Getting Started
Prerequisites
- Node.js (^22.22.2 || ^24.15.0 || >=26.0.0)
- npm
Installation
- Clone the repository:
git clone https://github.com/asizikov-demos/copilot-user-level-statistics-viewer.git
cd user-level-metrics-viewer
- Install dependencies:
npm install
- Run the development server:
npm run dev
- Open http://localhost:3000
Commands
npm run dev # Start development server with Turbopack
npm run build # Build for production (static export)
npm run lint # Run ESLint
npm run test:run # Run tests
Actions workflow lockfile
.github/workflows/actions.lock pins the direct and transitive action dependencies
of deploy.yml and update-plugins.yml. After changing their action references,
regenerate and verify the lockfile with the official CLI extension:
gh extension install github/gh-actions-lock
gh actions-lock .github/workflows/deploy.yml .github/workflows/update-plugins.yml
gh actions-lock --verify .github/workflows/deploy.yml .github/workflows/update-plugins.yml
Review both the lockfile and any action version changes generated by the tool.
Always pass these workflow paths: running without paths would also onboard the
agentic workflows, which use their own lock system described below.
See GitHub's workflow lockfile documentation.
Agentic workflows
The workflows in .github/workflows/*.md are compiled with gh aw v1.0.1.
After editing them, regenerate the .lock.yml files rather than editing generated YAML:
gh extension upgrade gh-aw --force # Upgrade even if the local extension is pinned
gh aw version # Confirm the compiler version before regenerating
gh aw compile
Keep the compiler-generated agentics-maintenance.yml alongside the lock files;
it handles expiration of workflow-created issues and pull requests.
The code duplication scan uses the documented sonnet model alias
to resolve an available model from the live Copilot catalog rather than pinning an unavailable model ID.
Model Sync enables Copilot SDK mode
for its proxy-aware web-fetch tool. Account policies can still restrict model availability.
Data Format
The application expects GitHub Copilot user-level metrics NDJSON files as provided by the GitHub Copilot Metrics Dashboard Export. See src/types/metrics.ts for the full CopilotMetrics interface.
Demo sample
public/data/sample-report.ndjson contains
synthetic usage data for 797 users in the May 24-June 20, 2026 reporting window,
including Copilot App usage, server-counted client traffic, and reporting-quality
observations. The data demonstrates app capabilities, not historical API
evidence. Client requests remain separate from legacy interactions and LOC.
Search the Users table for these profiles:
| Story | User | What to explore |
|---|
| App power user | agile-crab-walnut | App sessions, prompts, tokens, models, and impact from May 29 |
| CLI customizer | fearless-badger-apricot | Existing skills, custom agents, MCPs, slash commands, and plugins; CLI/SDK traffic |
| Multi-client user | agile-cobra-almond | App, CLI, editor, and rotating server-counted clients in daily details |
| Fleet Health recovery | agile-camel-sage | Missing telemetry from May 27, received telemetry from June 4, and met requirements from June 8 |
The sample includes both unreported and reported-empty client traffic. Recovery
observations do not erase earlier issues. No third-party-agent scenario is added.
Contributing
See CONTRIBUTING.md.
