Get Started
cli-usage

See where your
AI tokens go

A lightweight workspace CLI that reads local Codex and Copilot session files to report token usage — grouped by app, model, and time period.

Tracks usage from

🤖 Codex
🧑‍✈️ Copilot CLI
📦 copilot-usage
f6n-usage
Period      App     Model           Sess  Input   Output
Feb 28    codex   o3               3   48.2k   12.1k
Feb 28    copilot claude-sonnet    5   92.4k   31.7k
Feb 27    codex   o3               2   31.0k    8.4k
Feb 27    copilot claude-sonnet    8  145.6k   52.3k
Feb 26    codex   gpt-4.1          1   15.8k    4.2k
Total                                19  333.0k  108.7k

Beautiful terminal reports

Smart time grouping: sessions for recent activity, daily for weeks, monthly for long-term trends. One command, zero config.

  • Codex session JSONL files
  • Copilot CLI event streams
  • copilot-usage wrapper summaries
  • Watcher archive snapshots

Everything you need
to track AI usage

From automatic capture to detailed reports — cli-usage handles the full pipeline.

📊

Smart time grouping

Under 1 day of activity? Session table. Under 1 month? Daily table. Longer? Monthly rollups. Always the right view.

🔄

Copilot wrapper

Use f6n-copilot to launch Copilot with a built-in watcher sidecar. No second terminal needed.

👁️

Background watcher

Run f6n-usage watch to continuously archive Copilot session data with configurable polling intervals.

🔧

One-time setup

Run f6n-usage setup once to optionally install a system-level watcher that runs at startup.

🖥️

Cross-platform

Works on Windows, macOS, and Linux with platform-appropriate state directories and service installation.

📝

Session transcripts

Captures full conversation transcripts from Copilot sessions for review and reference.

Up and running in 3 steps

Build once. Setup once. Report anytime.

1

Run setup

One-time configuration. Optionally enables the startup watcher.

bunx @f6n/cli-usage setup
2

Use Copilot via wrapper

Auto-starts a watcher sidecar while Copilot runs.

bunx --package @f6n/cli-usage f6n-copilot --
3

View your report

See Codex + Copilot usage in one combined report.

bunx @f6n/cli-usage

What's in the report?

Each table row gives you full visibility into your AI coding spend.

  • Time period (month / day / session)
  • Application (codex or copilot)
  • Model name from event context
  • Session count (unique IDs)
  • Input, cached input, output tokens
  • Reasoning tokens and computed totals

Know your AI spend

One CLI. Every token from Codex and Copilot, grouped by model and time period. No API keys, no dashboards, no cloud.