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)

statusline
Searching Database…

What is this?AI Engineering Fluency (formerly the 'GitHub Copilot Token Tracker') tracks your AI token usage and fluency score across editors and CLIs, covering GitHub Copilot, Claude Code, Gemini CLI and other AI engineering tools, by reading your local session logs.
Is this one extension or several separate tools?It's a family of components sharing the same engine: a VS Code extension, a JetBrains plugin, a Visual Studio extension, a standalone Node.js CLI, a GitHub Copilot app canvas plugin, an Oh-My-Posh prompt segment, and an optional self-hosted sharing server.
How do I get it running?Pick the piece for your tool: install the VS Code extension from the Marketplace (or Open VSX for Chromium forks like Cursor, Windsurf, Trae, Void), the plugin from the JetBrains Marketplace, the Visual Studio extension from its gallery, or just run the CLI via npm/npx in any terminal with Node.js.
Do I need an editor to use it, or can I just run the CLI?No editor is needed for the CLI, it runs anywhere Node.js is installed. The editor integrations need VS Code (or a Chromium fork), a JetBrains IDE, or Visual Studio 2022+, plus an existing Copilot/agent session to read logs from.
What does setting up team-wide sharing involve?Sharing usage across a team means running your own lightweight API server (SQLite + Docker); there's no Azure requirement, but it is still self-hosted infrastructure you have to stand up, with GitHub-based auth reusing an existing Copilot session instead of API keys.
Where does my usage data go?Everything is read from local session logs and stays on your machine, unless you explicitly opt in to cloud sync or ask an agent in the Copilot app about your stats, in which case those numbers are sent to the model like any other tool result.
Can I see my token usage right in my terminal prompt?Yes, the Oh-My-Posh segment shows today's and 30-day token usage directly in your shell prompt, powered by the same CLI npm package used elsewhere in the project.
Was this project renamed?Yes, it was previously called 'GitHub Copilot Token Tracker' (copilot-token-tracker); if that old extension is still installed, the new one prompts you to migrate.
What does the fluency score dashboard show?Alongside raw token counts, the VS Code extension, JetBrains plugin and CLI surface a fluency score and usage analysis, plus environmental impact figures from the CLI.
Creator
rajbos
Size
27.9 MB
Stars
118
Age
1y
Commits · 90 Days