claude-usage

SKILL.md

Claude Usage Checker

Launches the Claude CLI interactively (PTY) and reads the /usage output to report your Claude Code / Claude Max quota.

Prerequisites

  • Claude CLI must be installed (npm i -g @anthropic-ai/claude-code) and logged in
  • If running claude shows "Missing API key", the user must log in manually first: open a terminal, run claude, and complete the browser login flow
  • Requires an interactive PTY — the agent will launch a local process and read its output (quota info only)

Steps

  1. Launch claude with PTY
  2. Wait for the welcome screen (poll until it appears)
  3. Send /usage + Enter
  4. Read the output (poll until usage data appears)
  5. Close with Escape then /exit
  6. Report the results

Commands

Installs
6
First Seen
Mar 15, 2026