Skip to content

README.md

Latest commit

 

History

History
188 lines (132 loc) · 5.88 KB

README.md

File metadata and controls

188 lines (132 loc) · 5.88 KB

Copilot Token Tracker — CLI

Command-line interface for analyzing GitHub Copilot token usage from local session files. Works anywhere Copilot Chat stores its session data — no VS Code required.

Quick Start

# Run directly with npx (no install required)
npx @rajbos/ai-engineering-fluency stats

# Or install globally
npm install -g @rajbos/ai-engineering-fluency
ai-engineering-fluency stats

Commands

stats — Session Overview

Show discovered session files, sessions, chat turns, and token counts.

ai-engineering-fluency stats
ai-engineering-fluency stats --verbose  # Show per-folder breakdown
GitHub Copilot Token Tracker - Session Statistics
==================================================

Editor Breakdown:
  Code (VS Code)          42 files   │  318 sessions  │  4,821 turns  │  2.1M tokens
  Code - Insiders          8 files   │   61 sessions  │    892 turns  │  401K tokens
  OpenCode                 3 files   │   18 sessions  │    204 turns  │   87K tokens

──────────────────────────────────────────────────────────────────────────────
Total                     53 files   │  397 sessions  │  5,917 turns  │  2.6M tokens

usage — Token Usage Report

Show token usage broken down by time period.

ai-engineering-fluency usage
ai-engineering-fluency usage --models  # Show per-model breakdown
ai-engineering-fluency usage --cost    # Show estimated cost
GitHub Copilot Token Tracker - Token Usage
==========================================

Period          Input Tokens    Output Tokens   Total Tokens
──────────────────────────────────────────────────────────
Today                  8,432           12,104         20,536
Last 7 days           52,871           74,209        127,080
Last 30 days         218,540          301,883        520,423
All time           1,841,200        2,312,650      4,153,850

  --models breakdown (last 30 days):
  gpt-4o                      312,540 tokens
  claude-3.5-sonnet            98,203 tokens
  o3-mini                      71,801 tokens
  gemini-2.0-flash             37,879 tokens

environmental — Environmental Impact

Show the environmental impact of your Copilot usage (CO₂ emissions, water usage, tree equivalents).

ai-engineering-fluency environmental
ai-engineering-fluency env  # Short alias
GitHub Copilot Token Tracker - Environmental Impact
====================================================

Based on your last 30 days of usage (520,423 tokens):

  CO₂ emissions    ~  0.42 kg CO₂e
  Water usage      ~  0.63 L
  Tree equivalent  ~  0.02 trees/year needed to offset

All figures are estimates based on published AI energy-use research.

fluency — Fluency Score

Show your Copilot Fluency Score across multiple categories (Prompt Engineering, Context Engineering, Agentic, Tool Usage, Customization, Workflow Integration).

ai-engineering-fluency fluency
ai-engineering-fluency fluency --tips  # Show improvement tips
GitHub Copilot Token Tracker - Fluency Score
============================================

Overall stage: Collaborator  ████████████░░░░  Stage 3 of 4

  💬 Prompt Engineering     Collaborator  ████████████░░░░
  📎 Context Engineering    Explorer      ████████░░░░░░░░
  🤖 Agentic                Collaborator  ████████████░░░░
  🔧 Tool Usage             Strategist    ████████████████
  ⚙️  Customization          Explorer      ████████░░░░░░░░
  🔄 Workflow Integration   Collaborator  ████████████░░░░

Run with --tips to see how to advance each category.

diagnostics — Search Locations & Stats

Show all locations searched for session files, whether each path exists, and per-location stats.

ai-engineering-fluency diagnostics
GitHub Copilot Token Tracker - Diagnostics
==========================================

Searching for session files...

  ✔  /home/user/.config/Code/User/workspaceStorage          42 files found
  ✔  /home/user/.config/Code/User/globalStorage              3 files found
  ✔  /home/user/.config/Code - Insiders/User/workspaceStorage  8 files found
  ✗  /home/user/.config/Code - Exploration/...              (path does not exist)
  ✔  /home/user/.local/share/opencode                        3 files found
  ✗  /home/user/.config/Cursor/...                          (path does not exist)

Total: 56 files across 3 editors

Data Sources

The CLI scans the same session files as the VS Code extension:

  • VS Code (Stable, Insiders, Exploration) workspace and global storage
  • VSCodium and Cursor editor sessions
  • VS Code Remote / Codespaces sessions
  • Copilot CLI agent mode sessions
  • OpenCode sessions (JSON and SQLite)
  • Claude Code sessions (Anthropic CLI/IDE extension, actual API token counts)

Requirements

  • Node.js 18 or later
  • GitHub Copilot Chat session files on the local machine

Development

# From the repository root
npm run cli:build           # Build the CLI
npm run cli:stats           # Run stats command
npm run cli:usage           # Run usage command
npm run cli:environmental   # Run environmental command
npm run cli:fluency         # Run fluency command
npm run cli:diagnostics     # Run diagnostics command
npm run cli -- --help       # Run any CLI command

License

MIT — see LICENSE for details.