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

agentbudget-dashboard

v0.1.0

Published

Open-source dashboard and demo app for live AgentBudget spend tracking

Downloads

13

Readme

AgentBudget Dashboard

Agent Budget Website | Agent Budget SDK Githup repository

The eyes of AgentBudget. Real-time budget intelligence, spend observability, and session risk visibility for AI agent workflows.

AgentBudget enforces hard spending limits. This dashboard helps teams see where spend moved, why it moved, and what happens next.

It transforms raw budget enforcement into live operational visibility.


Why this exists

AI agents do not just need hard limits.

Teams need to understand:

  • what is driving spend
  • which model or tool is causing cost spikes
  • how fast the session is burning
  • whether budget exhaustion is approaching
  • what changed in the last few minutes

AgentBudget already solves budget enforcement.

This project extends that into budget intelligence and real-time observability.

Think of it as the mission control layer for AgentBudget sessions.


Core idea

This dashboard is built as a companion product for the AgentBudget SDK.

While the SDK answers:

Should this session continue?

This dashboard answers:

Why is spend moving and what is causing the risk?

That visibility layer is critical for:

  • product teams
  • infra teams
  • AI platform teams
  • founders running AI-heavy workflows
  • enterprise observability use cases

What you can see 🔍

Live budget health

Track session health in real time with:

  • total spent
  • remaining budget
  • burn rate
  • risk status
  • projected exhaustion

Status states include:

  • SAFE
  • WATCH
  • DANGER

Spend progression

Visualize how session cost evolves over time.

Includes:

  • actual spend
  • projected spend
  • budget zone
  • burn velocity
  • trend windows

Time windows:

  • last minute
  • last 3 minutes
  • last 5 minutes
  • last 10 minutes
  • last 30 minutes
  • last hour
  • last 6 hours

Cost drivers

Understand what is moving spend.

Examples:

  • most expensive model
  • most expensive tool
  • largest single event
  • top cost contributors
  • recent acceleration

This turns spend tracking into causal analysis.


Session timeline

A narrative timeline of spend events.

Each event can show:

  • timestamp
  • event type
  • model
  • tokens
  • cost delta

This makes it easy to answer:

What happened right before cost increased?


Architecture

This project intentionally lives outside the core AgentBudget SDK.

The goal is to keep:

  • core enforcement lightweight
  • observability extensible
  • storage pluggable

This allows the dashboard to evolve independently.

Components

  • TrackedBudgetSession
  • timeline store
  • dashboard UI
  • demo application
  • memory / Redis persistence

Supported stores

In-memory

Perfect for local development and demos.

Redis

Recommended for production and multi-session persistence.

This enables:

  • session recovery
  • shared team visibility
  • live dashboards across instances
  • historical analysis

Product vision

AgentBudget protects budgets.

This dashboard helps teams operate them.

The long-term vision is to evolve this into a full AI spend observability layer.

Potential capabilities:

  • projected budget exhaustion ETA
  • anomaly detection
  • model cost comparison
  • per-tool cost attribution
  • org-level dashboards
  • team-based spend views
  • alerts and notifications
  • session replay
  • spend anomaly timeline

Why this matters

AI agent costs can escalate quickly.

A loop, oversized responses, or excessive tool usage can burn through budget unexpectedly.

Hard limits stop the damage.

Visibility helps prevent it.

This project is built around the belief that teams need both:

  • enforcement
  • observability

Together, they create operational confidence for AI systems in production.


Positioning

A simple way to think about this project:

AgentBudget enforces the limit. This dashboard gives teams the eyes to understand it.


Demo

Live dashboard example includes:

  • session spend
  • risk projection
  • cost timeline
  • event breakdown
  • model attribution

Contributing

Ideas and feedback are welcome.

Particularly interested in:

  • observability workflows
  • AI infra tooling
  • enterprise budget governance
  • cost anomaly detection
  • agent platform integrations

Built with the vision of becoming the official observability companion for AgentBudget.