rv-claude-commands

Claude Code commands for checking plan usage limits and token consumption.

Quick Start

# Install commands
npx rv-claude-commands install

# Set up Playwright MCP (required for /plan-limits)
npx rv-claude-commands setup-playwright

# Restart Claude Code, then try:
/plan-limits

Commands

| Command | Description | |---------|-------------| | /plan-limits | Check plan quotas (session/weekly %) from claude.ai | | /usage | Token costs (7-day summary) | | /usage-today | Today's token breakdown | | /usage-weekly | Weekly token summary | | /usage-session | Recent expensive sessions |

Prerequisites

For /plan-limits

Requires Playwright MCP to be configured in Claude Code.

Run the setup helper:

npx rv-claude-commands setup-playwright

First-time use:

1. Run /plan-limits in Claude Code
2. A browser window will open to claude.ai
3. Log in with your account
4. Tell Claude you're done
5. Future runs will remember your session

For /usage commands

Uses ccusage (bundled with this package).

CLI Commands

npx rv-claude-commands install           # Install commands
npx rv-claude-commands uninstall         # Remove commands
npx rv-claude-commands list              # Show available commands
npx rv-claude-commands setup-playwright  # Playwright MCP setup guide
npx rv-claude-commands help              # Show help

Example Output

/plan-limits

**Claude Plan Usage** ([email protected])

| Limit | Used | Resets |
|-------|------|--------|
| Session | 16% | in 2 hr 13 min |
| Weekly (All) | 22% | Tue 1:59 PM |
| Sonnet Only | 11% | Tue 3:59 PM |

Troubleshooting

"Playwright MCP tools not available"

Run npx rv-claude-commands setup-playwright and follow the instructions.

Login keeps expiring

This is normal - claude.ai sessions expire. Just log in again when prompted.

Commands not appearing in Claude Code

Restart Claude Code after running install.

License

MIT