npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@noctuacore/agent-bar

v5.3.0

Published

LLM quota monitor for Waybar - Claude, Codex, Amp

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

noctuacorenoctuacore

Keywords

waybarclaudecodexllmquota

Readme

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

Install

Recommended (zero pollution, runs setup automatically):

curl -fsSL https://raw.githubusercontent.com/othavioquiliao/agent-bar/master/install.sh | bash

Requires bun and git. Installs to ~/.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 update

Alternative: Bun global

If you already use Bun globally and prefer that workflow:

bun add -g @noctuacore/agent-bar && agent-bar setup

⚠ Don't drop the -g. Without it, bun add writes package.json + bun.lock to your current directory. If that happens, run agent-bar doctor to clean up.

Alternative: AUR (Arch)

On Arch, install the prebuilt standalone binary from the AUR — no Bun runtime required:

paru -S agent-bar-bin   # or: yay -S agent-bar-bin
agent-bar setup

Update it with your package manager (paru -Syu), not agent-bar update.

For development (live edits reflected in Waybar on the next poll), see CONTRIBUTING.md → Dev install.

Commands

agent-bar               # Waybar JSON
agent-bar status        # Terminal quota view
agent-bar menu          # Login and layout TUI
agent-bar update        # Update the install (npm package or managed checkout)
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 version

Use with other bars (Quickshell, Eww, Ironbar)

Waybar 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 an npm/Bun global install it updates the package. In a dev checkout it refuses and tells you to use git pull.

Docs