# Scope > Configure claude-scope status line widgets for Claude Code. Use when user wants to customize widgets, change theme, reorder elements, or modify display style. Use when this capability is needed. - Skill: `tomevault-io/scope-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/scope-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/scope-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/scope-2 --- # 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 ```json { "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: ```json // 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: ```json { "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: ```bash 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 | --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/yurinachos) — claim your Tome and manage your conversions.