usage-limits

v1.25.0

Reports how much of your Codex usage limit is left as turns of work rather than a percentage, prices a job before you start it, and counts the other agents sharing the same budget.

CodexClaude Code1 Skill

By RidelinkLicense: MIT0 GitHub starsUpdated last week

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 1 skill or MCP entry
Source updated: Sep 14, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install usage-limits for Codex and Claude Code

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add usage-limits@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/ridelink0/claude-code-usage-limits

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

usage-limits/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── skills/usage-limits/SKILL.md

Included Skills1

usage-limitsskills/usage-limits/SKILL.md

Check how much usage limit is left in this agent (Claude Code or Codex) and plan the work to fit inside it. Use before starting anything long, when the 5-hour or weekly limit is getting close, when asked how much usage or quota is left, whether there is enough left to finish, whether a job fits before the reset, when to stop and hand off, and when asked to work cheaply, burn fewer credits, or stretch the rest of the limit.

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "usage-limits",
  "version": "1.25.0",
  "description": "Reports how much of your Codex usage limit is left as turns of work rather than a percentage, prices a job before you start it, and counts the other agents sharing the same budget.",
  "author": {
    "name": "Ridelink",
    "url": "https://github.com/ridelink0"
  },
  "homepage": "https://github.com/ridelink0/claude-code-usage-limits",
  "repository": "https://github.com/ridelink0/claude-code-usage-limits",
  "license": "MIT",
  "keywords": [
    "usage",
    "limits",
    "quota",
    "rate-limit",
    "budget",
    "cost",
    "planning",
    "effort"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Usage Limits",
    "shortDescription": "How much usage limit is left, in turns of work",
    "longDescription": "Reads the usage figures Codex already writes to disk and turns them into something you can plan with: which window binds, how many turns of work is left in it, and whether the job in front of you fits before the reset. Prices a job before you start it, notices when several agents are sharing one budget, and says what to land and what to leave when the limit is close. Everything is read locally; nothing is uploaded and no credentials are read.",
    "developerName": "Ridelink",
    "category": "Developer Tools",
    "capabilities": [
      "Read"
    ],
    "websiteURL": "https://github.com/ridelink0/claude-code-usage-limits",
    "defaultPrompt": [
      "How much usage do I have left?",
      "Will this job fit before my limit resets?",
      "Finish this using as little usage as possible"
    ],
    "brandColor": "#0C0A03"
  }
}

.claude-plugin/plugin.json

{
  "name": "usage-limits",
  "displayName": "Usage Limits",
  "version": "1.25.0",
  "description": "Puts your remaining Claude Code usage limit into Claude's context before every prompt, so it opens with what fits in the budget instead of starting work that gets cut off. Reports headroom as turns rather than percentages, prices a job before you start it, and detects your plan tier.",
  "author": {
    "name": "Ridelink",
    "url": "https://github.com/ridelink0"
  },
  "homepage": "https://github.com/ridelink0/claude-code-usage-limits",
  "repository": "https://github.com/ridelink0/claude-code-usage-limits",
  "license": "MIT",
  "keywords": [
    "usage",
    "limits",
    "budget",
    "cost",
    "tokens",
    "planning",
    "effort"
  ]
}