copilot-powerline

A fast, modular, and customizable powerline status line for GitHub Copilot CLI, written in Rust. Inspired by claude-powerline.

Features

• ⚡️ Sub-5ms Execution: Compiled Rust binary with bundled SQLite; zero terminal latency or lag.
• 🎯 Context & Token Monitoring: Displays current vs max tokens with a percentage and a high-usage alert threshold (>100k).
• 💰 Spend Tracking: Real-time session spend and month-to-date aggregation (read directly from Copilot's local SQLite database).
• ⚙️ Configurable AIC Display: Easily toggle whether AI Credits (... AIC) are displayed alongside dollar amounts.
• 🎨 Multiple Styles: Choose from minimal (pipe separator), powerline (Nerd Font arrows), capsule (rounded pills), or plain.
• 🌈 Themes: Built-in support for colorblind, github, nord, tokyo-night, and plain. Automatically syncs with your Copilot theme if set to default.
• 🛠 Zero Dependencies: Bundles SQLite and JSON parsing directly into a single static binary.

Quick Start

1. Build and Install

# Clone the repository
git clone https://github.com/<username>/copilot-powerline.git
cd copilot-powerline

# Build and install to ~/.cargo/bin
cargo install --path .

2. Generate Default Configuration

copilot-powerline --init

This creates a default configuration file at ~/.copilot/powerline.toml.

3. Connect to GitHub Copilot CLI

Update your ~/.copilot/settings.json to use copilot-powerline:

{
  "statusLine": {
    "type": "command",
    "command": "copilot-powerline",
    "refreshInterval": 30
  }
}

(If ~/.cargo/bin is not in your global system PATH, specify ~/.cargo/bin/copilot-powerline).

Configuration (~/.copilot/powerline.toml)

copilot-powerline is configured via a simple TOML file:

style = "minimal"      # Options: "minimal", "powerline", "capsule", "plain"
theme = "colorblind"   # Options: "colorblind", "github", "nord", "tokyo-night", "plain"
segments = [
    "tokens",
    "session_cost",
    "month_cost",
]

[tokens]
enabled = true
show_percentage = true
alert_threshold = 100000
alert_icon = "⚠️ "

[session_cost]
enabled = true
prefix = "Session:"
currency_symbol = "$"
show_aic = false       # Set to true to show "(X.X AIC)"
decimal_places = 2

[month_cost]
enabled = true
prefix = "Month:"
currency_symbol = "$"
show_aic = false       # Set to true to show "(X AIC)"
decimal_places = 2

Command Line Options

# Test with sample JSON from stdin
echo '{"context_window":{"current_context_tokens":0,"displayed_context_limit":200000,"current_context_used_percentage":0},"ai_used":{"total_nano_aiu":0}}' | copilot-powerline

# Override style on the fly
copilot-powerline --style capsule
copilot-powerline --style powerline

# Override theme on the fly
copilot-powerline --theme nord

# Use a custom configuration file
copilot-powerline --config /path/to/custom-powerline.toml

License

MIT