scope

Claude Scope Configuration Skill

Help users configure their claude-scope status line widgets.

Configuration Path

Config file: ~/.claude-scope/config.json

Workflow

1. Read current config from ~/.claude-scope/config.json
2. Understand what the user wants to change
3. Edit the config using the Edit tool
4. Confirm changes to the user

Changes apply automatically on the next status line render cycle.

Quick Reference

Config Structure

{
  "version": "1.0.0",
  "theme": "monokai",
  "lines": {
    "0": [{ "id": "model", "style": "balanced", "colors": {...} }],
    "1": [{ "id": "git", "style": "balanced", "colors": {...} }]
  }
}

• lines is an object where keys are line numbers ("0", "1", "2", etc.)
• Each line contains an array of widget configurations
• Widgets render left-to-right within each line
• Empty lines should be empty arrays []

Available Widgets (16)

Available Themes (17)

monokai (default), nord, dracula, catppuccin-mocha, tokyo-night, vscode-dark-plus, github-dark-dimmed, dusty-sage, muted-gray, slate-blue, professional-blue, rose-pine, semantic-classic, solarized-dark, one-dark-pro, cyberpunk-neon, gray

Available Styles

Common Operations

Swap widgets within a line

Read config, change the order of widget objects in the line's array.

Example: Swap model and context on line 0:

// Before
"0": [{ "id": "model", ... }, { "id": "context", ... }]
// After
"0": [{ "id": "context", ... }, { "id": "model", ... }]

Swap entire lines

Exchange the arrays between two line keys.

Example: Swap line 0 and line 1 contents.

Add a widget

Add a widget object to the target line array. Use existing widgets in config as template for the colors field.

Example: Add docker widget to line 2:

{ "id": "docker", "style": "balanced", "colors": { "label": "...", "count": "...", "running": "...", "stopped": "..." } }

Remove a widget

Remove the widget object from the line array. Don't leave empty objects.

Move widget to different line

1. Remove widget object from source line
2. Add widget object to target line

Change theme

Update the "theme" field value.

Important: Changing theme also requires updating all colors fields in every widget. Recommendation: For full theme changes, suggest user run:

npx claude-scope quick-config

This provides an interactive menu with live preview.

Change widget style

Update the "style" field for the target widget.

Change all styles at once

Update "style" field for every widget in config to the same value.

Full Documentation

For detailed information about widgets, styles, colors, and themes, read the full documentation:

• Main reference: AI-CONFIG-GUIDE.md in claude-scope repository
• All widgets with examples: docs/WIDGETS.md
• Theme system: docs/THEME-SYSTEM.md
• Architecture: docs/ARCHITECTURE.md

Important Rules

1. Never break JSON structure - validate before saving
2. Preserve required fields - keep version and $aiDocs fields
3. Empty lines must be [] - don't remove line keys, use empty arrays
4. ANSI color format - colors use \u001b[38;2;R;G;Bm escape codes
5. Use existing colors as template - when adding widgets, copy colors from similar existing widgets

Example User Requests