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

@kunkun.sh/kuota

v0.1.0

Published

Truthful multi-provider AI quota monitoring, forecasting, and parsing library & CLI suite (OpenAI Codex, Claude Code, Google Antigravity)

Readme

@kunkun.sh/kuota

Truthful multi-provider AI subscription & quota suite: reusable TypeScript library, interactive TUI, headless CLI, and embedded loopback Web Workbench.

Supports OpenAI Codex, Anthropic Claude Code, and Google Antigravity.


🚀 CLI & Multi-Surface Usage

Run directly with zero installation via npx:

# 1. Interactive terminal TUI (full-screen UniView dashboard with % left & pace markers)
npx @kunkun.sh/kuota
npx @kunkun.sh/kuota tui

# 2. Web Workbench (embedded HTTP server + React 19 UI with 3D activity terrain & Dynamic Island)
npx @kunkun.sh/kuota web
npx @kunkun.sh/kuota web --port 5173 --no-open

# 3. Headless CLI commands (human readable or JSON)
npx @kunkun.sh/kuota status
npx @kunkun.sh/kuota status --json
npx @kunkun.sh/kuota doctor
npx @kunkun.sh/kuota pace
npx @kunkun.sh/kuota forecast
npx @kunkun.sh/kuota providers

📦 Library Usage

Install as a dependency in your application, server, or Kunkun extension:

npm install @kunkun.sh/kuota
# or
bun add @kunkun.sh/kuota

1. Unified AI Quota Parsers

Parse raw JSON / RPC payloads received from vendor CLIs or APIs into normalized, typed QuotaSnapshot structures:

import {
  parseProviderQuota,
  parseCodexRateLimits,
  parseClaudeOAuthUsage,
  parseAntigravityUsageReport,
  type QuotaSnapshot,
} from "@kunkun.sh/kuota";

// Universal dispatcher:
const snapshot: QuotaSnapshot = parseProviderQuota("codex", rawVendorData);

// Or direct modular imports (browser & edge friendly):
import { parseCodexRateLimits } from "@kunkun.sh/kuota/parsers";
const codexSnapshot = parseCodexRateLimits(rawAppServerResponse);

2. Time Budget & Ideal Pace Calculation

Calculate linear time-budget pace without guessing:

import { calculatePace, windowProfile } from "@kunkun.sh/kuota";

// Determine window cadence (e.g. 5h vs 7-day weekly)
const profile = windowProfile("codex", "primary", snapshot.windows[0].resetAt);

const pace = calculatePace({
  now: new Date(),
  startAt: new Date(Date.now() - 2 * 86_400_000),
  resetAt: new Date(snapshot.windows[0].resetAt!),
  usedPercent: snapshot.windows[0].usedPercent,
  semantics: profile.semantics,
  startSource: "provider",
});

if (pace) {
  console.log(`Ideal balance: ${pace.idealRemainingPercent}% remaining`);
  console.log(`Actual balance: ${100 - pace.actualUsedPercent}% remaining`);
  console.log(`Pace delta: ${pace.paceDeltaPoints > 0 ? "Ahead" : "Behind"} of pace`);
}

3. Live Provider Execution & Subprocess Service

Read quota directly from local installed developer tools (codex, claude, agy):

import { readAll, readCodex, createQuotaService } from "@kunkun.sh/kuota";
import { Effect } from "effect";

// Execute all detected providers via Effect TS
const program = readAll(["codex", "antigravity"]);
const snapshots = await Effect.runPromise(program);

// Or create a managed cached service
const service = createQuotaService();
const cachedCodex = await service.read("codex");

🧩 Subpath Exports

| Import Path | Description | | ----------- | ----------- | | @kunkun.sh/kuota | Full library (Parsers, Metrics, History, Providers, Schemas) | | @kunkun.sh/kuota/parsers | Pure data parsers (zero platform dependencies, Node & Browser safe) | | @kunkun.sh/kuota/metrics | Linear pacing algorithms and forecasting models | | @kunkun.sh/kuota/history | Append-only local JSONL journal and query engine | | @kunkun.sh/kuota/providers | Subprocess adapters for Codex, Claude, and Antigravity |


🔒 Security and Data Honesty

  • Zero credential leaks: API keys, tokens, session cookies, and private prompts are never stored, logged, or serialized.
  • Fail-safe status: Unavailable or unauthenticated accounts are reported as "unauthenticated" or "unavailable" with honest error codes, never fabricated as 0% left.
  • Shared peer dependencies: Core dependencies like effect and react are not bundled into an opaque monolith, avoiding dual-package hazard in consumer apps.

📄 License

MIT © Huakun Shen