Agentbar Menubar — Development skill for Claude Code

AgentBar

AgentBar is a local-first Linux tray app and CLI for monitoring usage, reset windows, spend, and status across coding tools and AI services.

It reads local provider CLIs, known config files, browser cookies, and provider usage endpoints only for features you enable. AgentBar does not send usage data to an AgentBar backend.


Features

• GNOME/AppIndicator tray label for active provider usage.
• GTK usage panel with provider tabs, reset windows, headroom, pace, and local spend history.
• Text and JSON CLI output for usage, config validation, and local cost scans.
• Local recommendations and notifications based on freshness, resets, pace, and headroom.
• Optional generated tray icons that show remaining-usage cues.
• Provider-aware local storage for account, plan, reset, and spend state.

Supported Providers

AgentBar includes adapters for Codex, Claude, OpenCode, OpenCode Go, Gemini, Antigravity, Copilot, z.ai, MiniMax, Kimi, Kimi K2, Kilo Code, Kiro, Vertex AI, Amp, Ollama, JetBrains AI, OpenRouter, Perplexity, Synthetic, and Warp.

Support depth varies. Some providers expose live plan and rate-limit data; others expose local usage, status, configured identity, or cost history when available.

Requirements

• Linux desktop session
• Swift 6.2 or newer
• GTK 3 and Ayatana AppIndicator development packages for tray builds
• GNOME AppIndicator support for tray visibility

On Ubuntu:

sudo apt install libgtk-3-dev libayatana-appindicator3-dev gnome-shell-ubuntu-extensions
gnome-extensions enable ubuntu-appindicators@ubuntu.com

Log out and back in if `org.kde.StatusNotifierWatcher` is still unavailable after enabling the extension.

Install

Build the tray app and install the desktop launcher:

./bin/install-agentbar-launcher.sh

Start AgentBar on login:

./bin/install-agentbar-autostart.sh

Install the CLI helper as `agentb