Commands

claude-dashboard provides four commands for setup, usage checking, shell integration, and updating.

/claude-dashboard:setup

Configure the status line display mode, language, plan, and theme.

Usage

# Interactive mode (asks questions)
/claude-dashboard:setup

# Direct mode with arguments
/claude-dashboard:setup [displayMode] [language] [plan] ["customWidgets"]

Arguments

Argument	Options	Default	Description
displayMode	compact, normal, detailed, custom	compact	Number of lines and widget selection
language	auto, en, ko	auto	UI language
plan	max, pro	max	Subscription plan (affects available rate limit widgets)
customWidgets	"widget1,widget2|widget3"	—	Custom layout (only for custom mode)

Examples

/claude-dashboard:setup                          # Interactive
/claude-dashboard:setup compact                  # 1 line, defaults
/claude-dashboard:setup normal en pro            # 2 lines, English, Pro
/claude-dashboard:setup detailed ko max          # 6 lines, Korean, Max
/claude-dashboard:setup custom auto max "model,context,cost|projectInfo,todoProgress"

Notes

• The status line updates on the next message after setup
• Run this command again at any time to change settings
• Interactive mode is best for preset selection; for full widget control, use direct mode or edit the JSON file directly

/claude-dashboard:check-usage

Check usage limits for all installed AI CLIs and get a recommendation for which one has the most available capacity.

Usage

/claude-dashboard:check-usage              # Interactive output with colors
/claude-dashboard:check-usage --json       # JSON output for scripting
/claude-dashboard:check-usage --lang ko    # Specify language
/claude-dashboard:check-usage --lang en    # Specify language

Output

Shows usage for each installed CLI:

• Claude: 5h and 7d rate limits with reset times
• Codex: Rate limits with plan info, if installed — each window is labeled by its actual duration (5h + 7d on Plus, a single 7d on Pro)
• Gemini: Usage percentage with model info (if installed)
• Antigravity: Weekly quota per model family — Gemini vs Claude+GPT (if installed)
• z.ai: Token and MCP usage with model info (if configured)

At the bottom, recommends the CLI with the lowest current usage.

/claude-dashboard:setup-alias

Add a check-ai shell alias to quickly check all AI CLI usage from your terminal. Supports macOS/Linux (zsh/bash) and Windows (PowerShell).

Usage

/claude-dashboard:setup-alias

After Setup

Once the alias is installed, you can run it directly from your terminal (outside of Claude Code):

check-ai          # Pretty output
check-ai --json   # JSON output for scripting

Platform Support

• macOS / Linux: Adds a shell function to ~/.zshrc or ~/.bashrc
• Windows: Adds a PowerShell function to your PowerShell profile

Notes

• The function dynamically finds the latest plugin version, so it continues to work after updates
• Run this command again if you need to reinstall the alias
• The alias works independently of Claude Code

/claude-dashboard:update

Repair or verify the statusLine shim (usually automatic).

Usage

/claude-dashboard:update

When to Use

Normally unnecessary — statusLine points at a permanent shim path (plugins/data/claude-dashboard-claude-dashboard/statusline.mjs) that resolves the newest installed build on every render, so a SessionStart hook keeps it current automatically after /plugin update claude-dashboard. Run this command only if you have hooks disabled or the status line is not updating.

What It Does

1. Installs or refreshes the shim at the permanent data-directory path and points statusLine in settings.json at it — $CLAUDE_CONFIG_DIR/settings.json if that variable is set, ~/.claude/settings.json otherwise
2. Reports which build the shim currently resolves to

If settings.json changed, it takes effect at your next interaction with Claude Code — no restart is needed.