Claude Dashboard Setup

Configure the claude-dashboard status line plugin with widget system support.

Arguments

• No arguments: Interactive mode (asks questions)
• With arguments: Direct configuration mode

Direct Mode Arguments

• $1: Display mode

  • compact (default): 1 line (model, context, cost, rate limits)
  • normal: 2 lines (+ project info, session, tools, todos)
  • detailed: 3 lines (+ config counts, agent status)
  • custom: Custom widget configuration (requires $4)

• $2: Language preference

  • auto (default): Detect from system language
  • en: English
  • ko: Korean

• $3: Subscription plan

  • max (default): Shows 5h + 7d rate limits
  • pro: Shows 5h only

• $4: Custom lines (only for custom mode)

  • Format: "widget1,widget2|widget3,widget4"
  • | separates lines
  • Example: "model,context,cost|projectInfo,todoProgress"

Available Widgets

Widget	Description
model	Model name with emoji
context	Progress bar, percentage, tokens
cost	Session cost in USD
rateLimit5h	5-hour rate limit
rateLimit7d	7-day rate limit (Max only)
rateLimit7dSonnet	7-day Sonnet limit (Max only)
projectInfo	Directory name + git branch
configCounts	CLAUDE.md, rules, MCPs, hooks counts
sessionDuration	Session duration
toolActivity	Running/completed tools
agentStatus	Subagent progress
todoProgress	Todo completion rate

Tasks

1. Determine configuration

If no arguments provided (interactive mode):

Use AskUserQuestion to ask the user:

1. First question: Display mode selection

   • Options: compact (recommended), normal, detailed, custom

2. If "custom" selected, ask for each line:

   • Line 1 widgets (multi-select from available widgets)
   • Ask if they want to add Line 2
   • If yes, Line 2 widgets (multi-select)
   • Ask if they want to add Line 3
   • Continue until they say no or reach 3 lines

If arguments provided (direct mode):

Use the provided arguments directly.

2. Create configuration file

Create ~/.claude/claude-dashboard.local.json:

For preset modes (compact/normal/detailed):

{
  "language": "$2 or auto",
  "plan": "$3 or max",
  "displayMode": "$1 or normal",
  "cache": {
    "ttlSeconds": 60
  }
}

For custom mode:

{
  "language": "$2 or auto",
  "plan": "$3 or max",
  "displayMode": "custom",
  "lines": [
    ["widget1", "widget2"],
    ["widget3", "widget4"]
  ],
  "cache": {
    "ttlSeconds": 60
  }
}

3. Update settings.json

Add or update the statusLine configuration in ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/index.js"
  }
}

Important: Use ${CLAUDE_PLUGIN_ROOT} for the plugin path.

4. Show example output

Display what the status line will look like based on their configuration:

Compact (1 line) - Default:

🤖 Opus │ ████████░░ 80% │ 160K/200K │ $1.25 │ 5h: 42% (2h30m) │ 7d: 69% │ 7d-S: 2%

Normal (2 lines):

🤖 Opus │ ████████░░ 80% │ 160K/200K │ $1.25 │ 5h: 42% (2h30m) │ 7d: 69% │ 7d-S: 2%
📁 project (main) │ ⏱ 45m │ ✓ 3/5

Detailed (3 lines):

🤖 Opus │ ████████░░ 80% │ 160K/200K │ $1.25 │ 5h: 42% (2h30m) │ 7d: 69% │ 7d-S: 2%
📁 project (main) │ ⏱ 45m │ ✓ 3/5
CLAUDE.md: 2 │ ⚙️ 12 done │ 🤖 Agent: 1

Examples

# Interactive mode
/claude-dashboard:setup

# Preset modes
/claude-dashboard:setup normal
/claude-dashboard:setup compact en pro
/claude-dashboard:setup detailed ko max

# Custom mode
/claude-dashboard:setup custom auto max "model,context,cost|projectInfo,todoProgress"

Notes

• The status line will update on the next message
• To change settings later, run this command again
• Custom mode allows full control over which widgets appear on each line