waybar-ai-usage

Waybar AI Usage

Monitor Claude Code, OpenAI Codex CLI, GitHub Copilot, OpenCode Zen, and Z.ai usage directly in your Waybar status bar.

This tool displays your AI coding assistant usage limits in real-time by reading browser cookies or API tokens. No API key needed for Claude, Codex, or OpenCode Zen — they use the browser session you're already signed into.

Contents

- What This Monitors
- Requirements
- Installation
- Setup — Claude, Codex, Copilot, Zen, Z.ai
- Usage
- Formatting Configuration — see also docs/formatting.md
- Display States
- Troubleshooting
- Contributing — see also CLAUDE.md

What This Monitors

- Claude Code: Claude's AI-powered code editor
  - 5-hour usage window
  - 7-day usage window
- OpenAI Codex CLI: OpenAI's command-line coding assistant
  - Primary (5-hour) window
  - Secondary (7-day) window
- GitHub Copilot: Monthly premium request quota (Pro/Pro+)
  - Requests consumed vs. included quota (default: 300)
  - Countdown to monthly reset (1st of month, 00:00 UTC)
- OpenCode Zen: Pay-as-you-go balance for curated coding models
  - Current account balance in USD
  - Color-coded warnings when balance is low
  - No API key needed - uses browser cookies
- Z.ai: Usage quota monitoring (GLM models)
  - 5-hour token usage window (percentage + reset timer)
  - Monthly tool quota (web search, web reader, ZRead)
  - Uses API token from config file

Requirements

- Linux with Waybar running
- A signed-in browser session for whichever cookie-based providers you monitor — Claude.ai, ChatGPT, OpenCode. See Setup for the supported browser list.
- GitHub fine-grained PAT — required for Copilot (see Setup)
- Z.ai API token — required for Z.ai (see Setup)
- Python 3.11+ and uv (install uv)

Installation

Method 0: AUR (Recommended on Arch)

Method 1: Using uv…