ai-engineering-fluency README

The project's README from github.com/rajbos/ai-engineering-fluency. As one markdown file: README.md.

AI Engineering Fluency

(Previously known as the "GitHub Copilot Token Tracker") AI Engineering Fluency

Track your GitHub Copilot token usage and AI Fluency across VS Code, Visual Studio, the GitHub Copilot app, and the command line. All data is read from local session logs โ€” nothing leaves your machine unless you opt in to cloud sync, or ask an agent in the GitHub Copilot app about your stats (the numbers it reads are then sent to the model like any other tool result; see what the agent sees).

Build Watch the Explainer Video

Supported AI engineering tools

VS Codeย  VSCodiumย  Cursorย  GitHub Copilot ย  JetBrainsย  Continueย  OpenCodeย  Crushย  Claudeย  Geminiย  Mistralย  Kiroย  Visual Studio

Pick your tool

๐Ÿ–ฅ๏ธ VS Code Extension (Chromium)

Real-time token usage in the status bar, fluency score dashboard, usage analysis, cloud sync, and more. Works with all Chromium-based VS Code forks โ€” VS Code, Windsurf, Cursor, VSCodium, Trae, Kiro, Void, and more.

Install - VS Code VS Code installs Install - Windsurf (Open VSX) Open VSX installs

# Install from the VS Code Marketplace
ext install RobBos.ai-engineering-fluency
๐Ÿ“ฆ Install in other Chromium-based editors (Open VSX) 
# VSCodium
codium --install-extension RobBos.ai-engineering-fluency

# Code OSS
code --install-extension RobBos.ai-engineering-fluency

# Windsurf
windsurf --install-extension RobBos.ai-engineering-fluency

# Cursor
cursor --install-extension RobBos.ai-engineering-fluency

# Trae (ByteDance)
trae --install-extension RobBos.ai-engineering-fluency

# Kiro (AWS)
kiro --install-extension RobBos.ai-engineering-fluency

# Void
void --install-extension RobBos.ai-engineering-fluency

๐Ÿ“– Full VS Code extension documentation

Previously known as copilot-token-tracker (deprecated): legacy installs โ€” If you still have it installed, the extension will prompt you to migrate.

๐Ÿฆ JetBrains IDE Plugin

Token usage and fluency dashboards inside any JetBrains IDE (IntelliJ IDEA, Rider, PyCharm, WebStorm, GoLand, RubyMine, CLion, โ€ฆ). Built as a thin Kotlin/JCEF host that reuses the same webview bundles as the VS Code extension and the same bundled CLI as the Visual Studio extension.

Install - JetBrains JetBrains installs

๐Ÿ“– JetBrains plugin docs ยท Debugging guide

๐Ÿ—๏ธ Visual Studio Extension

Token usage tracking inside Visual Studio 2022+, reading Copilot Chat session files directly.

Visual Studio Marketplace Installs

๐Ÿ“– Full Visual Studio extension documentation

โŒจ๏ธ CLI

Run anywhere with Node.js โ€” no editor required. Get usage stats, fluency scores, and environmental impact from the terminal.

npm downloads

npx @rajbos/ai-engineering-fluency stats

๐Ÿ“– Full CLI documentation

๐Ÿงฉ GitHub Copilot app canvas

A side-panel canvas for the GitHub Copilot app with your token usage, cost, sessions, usage charts and fluency score โ€” styled like the VS Code extension and powered by the CLI over your local session logs. Ships as the ai-fluency-canvas Copilot plugin; click both buttons in order (each opens a form you confirm in the app).

Step 1: Add marketplace Step 2: Install plugin

# Or with the Copilot CLI (the app shares the same ~/.copilot config)
copilot plugin marketplace add rajbos/ai-engineering-fluency
copilot plugin install ai-fluency-canvas@ai-engineering-fluency

Then ask the agent to "open the AI Engineering Fluency canvas".

๐Ÿ“– Copilot app canvas documentation

๐Ÿš Oh-My-Posh Segment

Display today's and 30-day token usage directly in your terminal prompt, powered by the CLI npm package.

 ๓ฑŠค 1.2K today ยท 45.3K 30d 

# Install the CLI globally first
npm install -g @rajbos/ai-engineering-fluency

Then add the segment to your oh-my-posh theme:

{
  "type": "text",
  "style": "diamond",
  "leading_diamond": "\ue0b6",
  "trailing_diamond": "\ue0b4",
  "foreground": "#ffffff",
  "background": "#005ca5",
  "cache": { "duration": "5m", "strategy": "session" },
  "template": " \uec1e {{ cmd \"ai-engineering-fluency\" \"segment\" }} "
}

๐Ÿ“– Full Oh-My-Posh segment setup & options

๐Ÿ’ฌ GitHub Copilot CLI Statusline (Experimental)

Show token usage in the GitHub Copilot CLI status bar via the experimental STATUS_LINE feature. Combines context tokens, session duration, line changes, and daily/30-day totals in one compact line.

main +2/-1 > ctx 123.5k/200.0k > ######.... > 00:12:34 > +42/-8 > 12.9M today ยท 1443.5M 30d

Configure %USERPROFILE%\.copilot\settings.json to point at the included scripts:

{
  "statusLine": {
    "type": "command",
    "command": "C:\\Users\\YOURUSER\\.copilot\\statusline.cmd",
    "padding": 1
  },
  "feature_flags": { "enabled": ["STATUS_LINE"] },
  "experimental": true
}

๐Ÿ“– Full Copilot CLI statusline setup

๐Ÿ”— Self-Hosted Sharing Server

Share usage data with your team without an Azure account. Run a lightweight API server on your own infrastructure โ€” team members configure a single endpoint URL and upload automatically via their existing GitHub session.

# docker-compose.yml
services:
  sharing-server:
    image: ghcr.io/rajbos/copilot-sharing-server:latest
    ports:
      - "3000:3000"
    environment:
      - GITHUB_CLIENT_ID=...
      - GITHUB_CLIENT_SECRET=...
      - SESSION_SECRET=${SESSION_SECRET:?Missing SESSION_SECRET}
      - BASE_URL=https://copilot.example.com
    volumes:
      - sharing_data:/data
volumes:
  sharing_data:

// VS Code settings โ€” the only thing team members configure
{
  "aiEngineeringFluency.backend.sharingServer.enabled": true,
  "aiEngineeringFluency.backend.sharingServer.endpointUrl": "https://copilot.example.com"
}

๐Ÿ“– Setup & configuration guide ยท Server developer docs

Contributing

Interested in contributing? Check out our Contributing Guide for:

We welcome contributions of all kinds โ€” bug fixes, new features, documentation improvements, and more!

ai-engineering-fluency (rajbos/ai-engineering-fluency)

Searching Databaseโ€ฆ