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

1. Clone the repository:

git clone https://github.com/asizikov-demos/copilot-user-level-statistics-viewer.git
cd user-level-metrics-viewer

2. Install dependencies:

npm install

3. Run the development server:

npm run dev

4. 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.