Copace 1.1.0

Copace CLI

A command-line tool to track your GitHub Copilot Premium usage pace throughout the month. Know at a glance whether you're on track, over-spending, or leaving budget on the table.

Why?

GitHub Copilot Premium usage resets monthly. It's easy to burn through your allowance early or forget to use it at all. Copace calculates where you should be based on how far through the month you are, compares that to your actual usage, and gives you a clear visual summary with actionable advice.

By default, only weekdays (Mon–Fri) are counted — because that's when most people code. Pass --include-weekends if your schedule differs.

Installation

Prerequisites

• .NET 10 SDK

As a global tool

dotnet tool install --global Copace

Then run from anywhere:

copace 42.5

From source

git clone https://github.com/sebbogle/Copace.git
cd Copace
dotnet run 42.5

Usage

copace <usage> [options]

Examples

# Weekday-only pacing (default)
copace 42.5

# Include weekends in the calculation
copace 42.5 --include-weekends

Output

Copace displays:

• Current Usage — the percentage you entered
• Expected Usage — where you should be based on elapsed weekdays (or calendar days)
• Difference — how far ahead or behind you are, with a status label
• Projected End-of-Month — where you'll land if you continue at the current rate
• Progress Bar — a visual bar comparing actual vs. expected usage
• Advice — a contextual tip based on your pace status

Pace Statuses

Project Structure

Program.cs              → CLI wiring (System.CommandLine v3)
Models/
  PaceResult.cs         → Immutable record + PaceStatus enum
Services/
  PaceCalculator.cs     → Pure calculation logic (static)
  ConsoleRenderer.cs    → Colored terminal output (static)