explaingit

kunchenguid/quota-axi

Analysis updated 2026-05-18

33TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

A CLI and agent skill that reports how much quota is left on your local Claude, Codex, Cursor, Copilot, Grok, and Kimi subscriptions.

Mindmap

mindmap
  root((quota-axi))
    What it does
      Reads local quota state
      Reports usage windows
      Data only, no routing
    Tech stack
      TypeScript
      Node.js
      TOON format
    Use cases
      Check remaining AI quota
      Avoid hitting rate limits
      Compare provider usage
    Audience
      AI agent users
      Developers
    Providers
      Claude
      Codex
      Cursor
      Copilot

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check remaining quota across Claude, Codex, Cursor, Copilot, Grok, and Kimi in one command.

USE CASE 2

Let an AI agent decide where to route work based on which provider has quota left.

USE CASE 3

Install it as an agent skill so your assistant checks quota automatically before running tasks.

USE CASE 4

Inspect which local authentication sources are available for each provider without exposing secrets.

What is it built with?

TypeScriptNode.jsnpm

How does it compare?

kunchenguid/quota-axidavidichalfyorov-wq/openxivgenie-sa/genie-react
Stars333333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/55/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js 22.19+ and, on macOS, a one time Keychain permission grant for live Claude quota.

The README does not state a license, so reuse terms are unknown until the repository's license file is checked.

In plain English

quota-axi is a command line tool that tells an AI coding agent how much usage quota is left on the various AI subscriptions you have installed locally, so the agent can make smarter decisions about where to run work instead of running blind into a rate limit. It reports quota windows for Claude, Codex, Cursor, GitHub Copilot, Grok, and Kimi in a single call, showing things like what percentage of each usage window remains and when that window resets. The tool is described as data only. It does not route your requests to a different provider, does not recommend which one to use, does not proxy or intercept traffic, does not log in on your behalf, and does not import cookies from your browser or change any provider's account state in any way. It simply reads the quota information that is already available locally and reports it back. To gather that information, quota-axi reads the authentication credentials each tool already has stored on your machine, such as OAuth tokens or config files for Claude, Codex, Cursor, Copilot, Grok, and Kimi, and calls each provider's own official quota, usage, billing, or entitlement endpoint directly. All of these calls happen from the machine that holds the credentials and go straight to the first party provider, never through a third party relay server. A separate update command is the only feature that talks to npm, and only when the user runs it on purpose. By default the output is printed in a compact format called TOON, designed to use fewer tokens when an AI agent reads it, though a --json flag is available for a more standard structured output. There is also an auth command that shows which local credential sources are available for each provider without ever printing the actual secret values. The recommended way to install quota-axi is as an agent skill using the Agent Skills format, through a command like npx skills add, so an agent can call it on demand without anything needing to be pre-installed. It can also be run directly with npx, installed globally through npm, or built from source, and it requires Node.js version 22.19 or newer. On macOS, reading Claude's live token from the system Keychain requires the user to grant permission once, after which future quota checks work automatically.

Copy-paste prompts

Prompt 1
Run quota-axi and tell me which of my AI subscriptions is closest to its limit.
Prompt 2
Install quota-axi as an agent skill in my project and show me how to invoke it.
Prompt 3
Explain the difference between quota-axi's TOON output and its --json output.
Prompt 4
Show me how to grant Keychain access so quota-axi can read my live Claude quota on macOS.

Frequently asked questions

What is quota-axi?

A CLI and agent skill that reports how much quota is left on your local Claude, Codex, Cursor, Copilot, Grok, and Kimi subscriptions.

What language is quota-axi written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, npm.

What license does quota-axi use?

The README does not state a license, so reuse terms are unknown until the repository's license file is checked.

How hard is quota-axi to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is quota-axi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.