Waybar modules for watching agent CLI usage limits: remaining quota, used quota, reset windows, and login/error state.
Supported providers:
- Claude Code
- OpenAI Codex
- Amp
Hosted installer (recommended — runs setup automatically):
curl -fsSL https://raw.githubusercontent.com/othavioquiliao/agent-bar/master/install.sh | bashInstalls the standalone binary to ~/.local/bin/agent-bar and runs
agent-bar setup.
setup installs the Waybar modules, CSS, provider icons, terminal helper, and
~/.local/bin/agent-bar symlink.
To update later, run:
agent-bar updateyay -S agent-bar-bin # or: paru -S agent-bar-bin
agent-bar setupUpdate with your package manager (paru -Syu), not agent-bar update.
cargo binstall agent-bar
agent-bar setupFor development (building from source), see CONTRIBUTING.md.
agent-bar # Waybar JSON
agent-bar status # Terminal quota view
agent-bar menu # Login and layout TUI
agent-bar update # Update the install (managed checkout or system package)
agent-bar setup # Re-apply Waybar integration
agent-bar uninstall # Interactive removal
agent-bar remove # Forced removal
agent-bar doctor # Detect & clean leftovers in $HOME
agent-bar --version # Print versionWaybar is the default, but any bar can consume the raw, versioned JSON contract:
agent-bar --format json # one-shot structured JSON (all providers, no Pango)
agent-bar --watch # stream NDJSON: one JSON object per line (default 60s)See JSON output for the schema and a Quickshell example.
agent-bar update detects the install type. For the managed ~/.agent-bar
checkout (the install.sh path) it fetches and resets to upstream. For a system
package (AUR), it defers to the package manager. In a dev checkout it refuses
and tells you to use git pull.