scope

name	scope
description	Configure claude-scope status line widgets for Claude Code. Use when user wants to customize widgets, change theme, reorder elements, or modify display style.
user-invocable	true
allowed-tools	Read, Edit
argument-hint	["configuration change in natural language"]

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)

Widget ID	Description	Typical Line
cwd	Current working directory	0
model	Claude model name (e.g., "Claude Opus 4.5")	0
context	Context window usage with progress bar	0
cost	Session cost in USD	0
duration	Session elapsed time	0
lines	Lines added/removed during session	0
git	Current git branch and changes	1
git-tag	Latest git tag	1
config-count	CLAUDE.md, rules, MCPs, hooks counts	1
cache-metrics	Cache hit rate and cost savings	1
active-tools	Running and completed Claude tools	2
dev-server	Dev server status (Nuxt, Next, Vite)	2
docker	Docker container count and status	2
sysmon	System metrics (CPU, RAM, Disk, Network)	3
poker	Random poker hand (easter egg)	4
empty-line	Blank separator line	any

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

Style	Description
balanced	Clean, balanced with labels (default)
compact	Minimal, condensed
playful	Fun with emojis
verbose	Full text labels
technical	Raw values, no formatting
labeled	Explicit prefix labels
minimal	Most compact, no labels

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

User says	Action
"Swap first and second line"	Exchange lines "0" and "1" arrays
"Add docker widget"	Add docker widget to appropriate line
"Remove cost widget"	Remove cost widget from its line
"Make everything compact"	Change all widget styles to "compact"
"Use Dracula theme"	Update theme field (suggest quick-config for colors)
"Move git to first line"	Remove git from current line, add to line 0
"Show current config"	Read and display the config file