report-limit

Installation
SKILL.md

Dual-host. Detect the host you are running under:

  • Claude Code: Claude Code does not state its 5h window, so the script rebuilds it from cached timelines and statusline samples. Ask the plan (below), then run with --host claude.
  • Codex: Codex states each limit outright — used percent, window length, reset instant. The script pairs every recorded limit window with the tokens spent inside it. Do not ask the plan: Codex records it. Run with --host codex.
  • Resolve PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT}}", falling back to two levels above this skill's directory if both are unset.

Report 5-hour and weekly limit windows to GitHub Discussions. Pure rule-based — no LLM reasoning needed.

Help

ONLY show help if the user's argument literally contains the word "help" (e.g. /report-limit help). If no argument or any other argument is given, SKIP this section entirely and proceed to execution.

If the user provides "help" as argument, show usage summary and stop:

/report-limit — Report your rate limit data
Installs
6
GitHub Stars
35
First Seen
Jun 9, 2026