Agentbar Menubar banner
black-swann black-swann

Agentbar Menubar

Development community

Description

GNOME/Linux tray app for monitoring provider usage, resets, spend, and headroom

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

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.

![AgentBar usage panel and tray indicator](docs/assets/agentbar-readme-screenshot.png)

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