🌿 base-claude-statusline

A compact status line for Claude Code.

It shows, on one line:

📁 my-project | ⎇ main | 🤖 Opus [high] | 🌿 ctx: 42% | 🕐 5h: 55% (50m) | 📅 7d: 72% (Tue 09:00 AM)

| Segment | Meaning | | ---------- | ------------------------------------------------------------------ | | 📁 | Current directory name | | ⎇ | Git branch | | 🤖 | Model name, plus the effort level when it isn't medium | | 🌿 ctx | Context window used (white under 50%, yellow under 75%, red above) | | 🕐 5h | 5-hour rate limit used, with time until reset | | 📅 7d | 7-day rate limit used, with the reset day and time |

Segments whose data isn't available are left out.

📋 Requirements

• 🐚 bash
• 🔧 jq (brew install jq or apt install jq)
• 📦 Node.js, for the npx installer
• 🔀 git, for the branch segment

🍎 🐧 Works on macOS and Linux.

🚀 Install

💡 Pick one method. Both set the status line up for a single project. Restart Claude Code (or start a new session) afterwards to see it.

⚡ Option 1: Automatic (npx)

1. Make sure Node.js and jq are installed.

2. Open a terminal in the project where you want the status line.

3. Run:

   npx @trquth/base-claude-statusline

   The installer copies the script to .claude/statusline.sh, sets statusLine in .claude/settings.json (keeping your other settings) and warns if jq is missing. Before changing settings.json it asks a Yes/No question (default Yes); answer No to copy only the script and wire it up yourself. Add --yes (or -y) to skip the question; it is also skipped when the input is not a terminal.

4. Restart Claude Code.

If .claude/settings.json already has a different statusLine, the installer leaves it alone. To replace it, add --force:

npx @trquth/base-claude-statusline --force

To update later, run npx @trquth/base-claude-statusline@latest. From a clone, npx /path/to/base-claude-statusline works too.

🛠️ Option 2: Manual

1. Make sure bash and jq are installed.

2. Get scripts/statusline.sh from this repo (clone it, or download that one file).

3. From your project root, copy it into place and make it executable:

   mkdir -p .claude
   cp /path/to/base-claude-statusline/scripts/statusline.sh .claude/statusline.sh
   chmod +x .claude/statusline.sh

4. Open .claude/settings.json, creating it if it doesn't exist, and add the statusLine entry. Keep any settings already in the file:

   {
     "statusLine": {
       "type": "command",
       "command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/statusline.sh"
     }
   }

5. Restart Claude Code.

🗑️ Uninstall

From the same project, run:

npx @trquth/base-claude-statusline --uninstall

This deletes .claude/statusline.sh and removes statusLine from .claude/settings.json, keeping your other settings. It deletes settings.json and .claude/ only if they end up empty. If statusLine was set to something other than this status line, it is left alone; add --force to remove it anyway.

To undo it by hand, delete .claude/statusline.sh and remove the statusLine entry from .claude/settings.json.

🧪 Try it without installing

Pipe sample JSON into the script:

echo '{"cwd":"'"$PWD"'","model":{"display_name":"Opus"},"context_window":{"used_percentage":42}}' | bash scripts/statusline.sh