kc-statusline-setup

Statusline Setup

Install a Claude Code statusline that shows model, git branch, context usage bar, and Anthropic 5h/7d usage quota.

Flow

digraph setup {
  rankdir=TB;
  node [shape=diamond];
  has_config [label="settings.json\nhas statusLine?"];
  has_usage [label="Script contains\nusage display?"];

  node [shape=box];
  read [label="Read settings.json"];
  check_script [label="Read statusline script\ngrep for usage indicators"];
  already [label="Already configured\nNothing to do"];
  confirm [label="STOP: ask user\nReplace? (y/n)"];
  install [label="Install hyperfocus-statusline.js\nUpdate settings.json"];
  verify [label="Verify + restart notice"];

  read -> has_config;
  has_config -> check_script [label="yes"];
  has_config -> install [label="no"];
  check_script -> has_usage;
  has_usage -> already [label="yes"];
  has_usage -> confirm [label="no"];
  confirm -> install [label="user says y"];
  confirm -> already [label="user says n"];
  install -> verify;
}

Step 1: Read Current Config

Read → ~/.claude/settings.json

Look for the "statusLine" key. If no entry exists → go to Step 3.

If found, extract the script file path from the command field. The command is typically node "/path/to/script.js" — extract the quoted JS path after node.

If the referenced script file does not exist (dead reference) → treat as "no statusLine" → go to Step 3.

Step 2: Check Existing Statusline

Read the extracted script file.

Usage indicators (any one = already configured):

• getAnthropicUsage function name
• oauth/usage API path
• five_hour or seven_day response field

If ANY indicator found:

Your statusline already displays Anthropic usage quota. Nothing to do.

Current: <command path>

→ DONE. Do not modify anything.

If NO indicator found:

Your statusline does not include Anthropic usage quota.

Current: <command path>

Replace with hyperfocus statusline? This includes:
  - Model display
  - Directory + git branch
  - Context usage bar (with bridge file for context pressure hooks)
  - Anthropic 5h/7d usage quota

Your current statusline script will NOT be deleted — only the settings.json
pointer changes. You can revert by pointing back to the old script.

Replace? (y/n)