statusline-wizard_skill

Overview

This skill is an interactive setup wizard for configuring Claude Code's custom status line with visual progress bars and display options. It guides you through OS detection, backs up existing configurations if present, and writes a cross-platform script and settings entry. The wizard gathers preferences via focused questions and makes the status line ready-to-run.

How this skill works

The wizard detects your OS (macOS/Linux/Windows), checks ~/.claude/settings.json for an existing statusLine entry, and offers to back up or replace it. It runs a short AskUserQuestion workflow to collect display choices (context, project, session), writes the appropriate script (.sh or .ps1), updates settings.json with the command entry, and makes the script executable on macOS/Linux. A success message shows file locations and next steps.

When to use it

• Setting up a custom status line for Claude Code for the first time
• Switching which elements appear in the status line (model, tokens, branch, etc.)
• Adding a visual token usage progress bar to monitor context consumption
• Migrating or re-creating the status line on a new machine
• Enabling cross-platform status line scripts (bash or PowerShell)

Best practices

• Run the wizard without any command-line arguments — any provided text is ignored
• Back up existing ~/.claude/settings.json when prompted to preserve prior configuration
• Keep default selections if you want a compact, informative status line (model, token count, progress, directory, branch)
• Use the SHOW_* variables at the top of the generated script for quick customization without rerunning the wizard
• On macOS/Linux ensure chmod +x ~/.claude/statusline.sh after creation (the wizard attempts this)

Example use cases

• Developer wants a live token usage and progress bar while iterating on prompts
• Engineer needs a compact status line showing current repo branch and directory during pairing sessions
• Power user customizes which session metrics appear (duration, time, version) for billing awareness
• Team member copies configuration to a Windows machine and generates the PowerShell script automatically