statusline

Devloop Statusline Setup

Configure the devloop statusline to display real-time session information.

What the Statusline Shows

• Model: Current model name (Opus/Sonnet/Haiku)
• Context: Progress bar + percentage of context window used
• Tokens: Total session tokens (formatted as K/M)
• Path: Current working directory (shortened)
• Git Branch: Current branch name
• Plan Progress: Tasks completed (X/Y) from .devloop/plan.md

Step 1: Read Current Settings

Read the user's Claude Code settings:

Read ~/.claude/settings.json

Step 2: Check Current Status

Analyze the settings to determine the current state:

1. No statusLine field: Safe to configure
2. Existing devloop statusline: May need path update
3. Other statusline: Ask user what to do

Step 3: Get Plugin Path

The devloop statusline script path follows this pattern: ~/.claude/plugins/cache/cc-plugins/devloop/{version}/statusline/devloop-statusline.sh

Find the installed version by checking the plugin cache directory.

Step 4: Handle Based on State

If no statusline configured:

Add the statusLine field to settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/plugins/cache/cc-plugins/devloop/{version}/statusline/devloop-statusline.sh",
    "padding": 0
  }
}

If existing devloop statusline:

Check if path needs updating (version change). Update if necessary.

If other statusline configured:

AskUserQuestion:
  questions:
    - question: "You have an existing statusline configured. What would you like to do?"
      header: "Statusline"
      multiSelect: false
      options:
        - label: "Replace with devloop"
          description: "Use devloop statusline instead"
        - label: "Keep existing"
          description: "Don't change current statusline"

Step 5: Apply Configuration

Use the Edit tool to update ~/.claude/settings.json with the statusLine configuration.

Step 6: Confirm

Tell the user:

• Statusline has been configured
• Restart Claude Code to see the changes
• The statusline shows: Model, Context %, Tokens, Path, Git branch, Plan progress

Dependencies

The statusline requires jq for JSON parsing. If not installed:

• macOS: brew install jq
• Ubuntu/Debian: sudo apt install jq
• Windows: choco install jq

Troubleshooting

If the statusline doesn't appear after restart:

1. Verify jq is installed: which jq
2. Check settings.json is valid JSON
3. Ensure the script path exists and is executable
4. Try running the script manually to test

Customization

To customize the statusline:

1. Copy the script: cp ~/.claude/plugins/cache/cc-plugins/devloop/*/statusline/devloop-statusline.sh ~/.claude/statusline.sh
2. Edit ~/.claude/statusline.sh to your preferences
3. Update settings.json to point to your custom script