usage-mod

v0.1.3

Your Claude Code usage as colored chips above the prompt: 5h and weekly limits (% left), session cost and spend history. /usage-mod opens the full view.

Claude Code

By Kien Hoang TrungLicense: MIT0 GitHub starsUpdated 2 hours ago

Directory evidence

Runtimes: Claude Code
Parsed components: 0 skill or MCP entries
Source updated: Oct 3, 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-mod for Claude Code

Installs for the current user

claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install usage-mod@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. 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/kreddevils18/claude-usage-mod

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-mod/

└── .claude-plugin/plugin.json

Plugin manifests1

.claude-plugin/plugin.json

{
  "name": "usage-mod",
  "version": "0.1.3",
  "description": "Your Claude Code usage as colored chips above the prompt: 5h and weekly limits (% left), session cost and spend history. /usage-mod opens the full view.",
  "author": {
    "name": "Kien Hoang Trung",
    "url": "https://github.com/kreddevils18"
  },
  "homepage": "https://github.com/kreddevils18/claude-usage-mod",
  "repository": "https://github.com/kreddevils18/claude-usage-mod",
  "license": "MIT",
  "keywords": [
    "usage",
    "rate-limits",
    "cost",
    "statusline",
    "chips",
    "claude-code-mod"
  ],
  "types": "./types/index.d.ts",
  "userConfig": {
    "refreshMinutes": {
      "type": "number",
      "title": "Spend refresh minutes",
      "description": "How often the transcripts are re-read for Today, Yesterday and 30-day spend",
      "default": 5
    },
    "view": {
      "type": "string",
      "title": "Band",
      "description": "Show the chip band above the prompt",
      "default": "band",
      "options": [
        "band",
        "off"
      ]
    },
    "showSpend": {
      "type": "boolean",
      "title": "Show today spend",
      "description": "Add a Today spend chip to the band on wide screens",
      "default": true
    },
    "planRefreshMinutes": {
      "type": "number",
      "title": "Plan limits refresh minutes",
      "description": "How often Anthropic's plan usage API is asked for Fable, extra usage and resets (5 at the least). Every open session shares one reply, and a session with no turn waits up to 30 minutes.",
      "default": 15
    },
    "planLimits": {
      "type": "boolean",
      "title": "Plan limits from Anthropic",
      "description": "Ask Anthropic's plan usage API (what /usage reads) for the limits Claude Code does not report, such as Fable and extra usage. Uses your signed-in session through Claude Code; the token never reaches the mod.",
      "default": true
    },
    "interactive": {
      "type": "boolean",
      "title": "Tooltips and animation (desktop)",
      "description": "Draw the band and pane as interactive SVG: hover tooltips and Pac-Man's chomp. The desktop app redraws an interactive SVG by reloading its frame, so turn this off if the band flickers.",
      "default": true
    }
  }
}