gitwtfhub

wtf is am-i-cooked?

telegraphic-dev/am-i-cooked — explained in plain English

Analysis updated 2026-05-18

4JavaScriptAudience · developerComplexity · 2/5Setup · moderate

TL;DR

A small Node.js tool that checks your AI coding subscription quota before you start heavy tasks. It tells you if you have enough allowance left so you don't hit limits mid-run.

Mindmap

mindmap
  root((quota-gate))
    What it does
      Checks remaining quota
      Blocks prompts if low
      Returns JSON decisions
    How to install
      Claude Code plugin
      Skills.sh package
      Clone for development
    How it works
      Standalone command
      Automatic hook mode
      Environment variable config
    Credentials
      macOS Keychain support
      Linux Windows files
      Refreshes tokens in memory
    Outputs
      Allowed with usage
      Not allowed with reason
      Exit codes 0 1 or 2
    Use cases
      Check before heavy tasks
      Auto-gate prompts
      Avoid mid-run limits

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

Why would anyone build with this?

REASON 1

Check your remaining Claude or Codex quota before starting a long automated coding task.

REASON 2

Set up an automatic gate in Claude Code that blocks prompts when your quota drops below 10%.

REASON 3

Run a standalone quota check from the command line and read the JSON decision in scripts.

REASON 4

Integrate quota checks into your workflow so you avoid hitting subscription limits mid-task.

What's in the stack?

Node.jsJavaScript

How it stacks up

telegraphic-dev/am-i-cookedamirmahdavi2023/d1-adminanil-matcha/open-poe-ai
Stars444
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-25
MaintenanceActive
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires existing Claude or Codex CLI credentials and choosing between plugin install, skills.sh, or cloning the repo.

No license information was mentioned in the explanation, so the license terms are unknown.

Wtf does this do

quota-gate is a small Node.js tool that checks how much of your AI coding subscription quota is left before you start a long or expensive task. It supports Claude Code and Codex, reading the same local credentials their command-line tools already store. The idea is simple: before you kick off automated or heavy work, the tool tells you whether you have enough quota remaining, or whether you should wait. It returns a clear allow or skip decision in a format programs can read. Installation depends on how you want to use it. You can install it as a Claude Code plugin, which lets it automatically intercept prompts before they run. You can also install just the skill documentation through a package called skills.sh, or clone the repository directly for local development. The README provides specific commands for each path. The tool can run as a standalone command or as an automatic hook inside Claude Code. As a hook, it checks your quota each time you submit a prompt. If your remaining quota is above a floor (10% by default), the prompt proceeds silently. If quota is below the floor or cannot be determined, the hook blocks the prompt and returns a JSON object explaining why. You can adjust the floors and other behavior with environment variables. The standalone command has stricter defaults for manual checks. Every check produces JSON output with a clear decision. If quota is sufficient, it says allowed with your current usage numbers. If quota is below your threshold, it says not allowed and explains the reason. If credentials are missing or a usage endpoint fails, it also blocks and reports the problem. Exit codes follow a simple contract: zero means continue, two means stop because quota is low, one means stop because something went wrong. The tool reuses your existing Claude and Codex credentials directly. On macOS it looks in the Keychain first, then falls back to credential files. On Linux and Windows it reads credential files. It also refreshes expired tokens in memory when needed, without writing them back to disk. Additional provider support can be added without needing a separate app. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
Install quota-gate as a Claude Code plugin and configure it to block prompts automatically when my remaining quota drops below 15%.
Prompt 2
Run the quota-gate standalone command and show me the JSON output so I can see my current Claude and Codex usage before starting a long refactor.
Prompt 3
Set up environment variables for quota-gate so that the hook floor is 20% for Claude Code and credentials are read from my macOS Keychain.
Prompt 4
Write a shell script that calls quota-gate, reads the exit code, and only proceeds with my automated build if the exit code is zero.
Prompt 5
Help me clone the quota-gate repository, install its dependencies, and run it locally to check my Codex quota before a batch task.

Frequently asked questions

wtf is am-i-cooked?

A small Node.js tool that checks your AI coding subscription quota before you start heavy tasks. It tells you if you have enough allowance left so you don't hit limits mid-run.

What language is am-i-cooked written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript.

What license does am-i-cooked use?

No license information was mentioned in the explanation, so the license terms are unknown.

How hard is am-i-cooked to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is am-i-cooked for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.