@botaoxyz/claude-statusline

A custom status line for Claude Code, displaying model info, working directory, git status, and context window usage — all in your terminal.

 Opus |  my-project |  main ⇡2 [+!?] |  █████░░░░░░░░░░ 32.5%

Prerequisites

Nerd Fonts

This status line uses Nerd Fonts icons. You must install a Nerd Font and configure your terminal to use it, otherwise icons will not render correctly.

1. Download a patched font from nerdfonts.com (recommended: JetBrainsMono Nerd Font, FiraCode Nerd Font, or MesloLGS Nerd Font)
2. Install the font on your system
3. Set your terminal emulator's font to the installed Nerd Font

Node.js

Requires Node.js >= 18.

Installation & Usage

Option 1: Global Install

npm install -g @botaoxyz/claude-statusline

Then add to your Claude Code configuration (~/.claude/settings.json):

{
  "statusLine": {
    "type": "command",
    "command": "claude-statusline"
  }
}

Option 2: npx / bunx (No Install)

No global installation needed — just reference the package directly:

{
  "statusLine": {
    "type": "command",
    "command": "npx @botaoxyz/claude-statusline"
  }
}

Or with Bun:

{
  "statusLine": {
    "type": "command",
    "command": "bunx @botaoxyz/claude-statusline"
  }
}

What It Shows

| Section | Icon | Description | | ------- | ---- | ----------- | | Model | | Current Claude model name (e.g. Opus, Sonnet) | | Directory | | Basename of the working directory | | Git | | Branch name + file status + ahead/behind | | Context | | Context window usage bar with percentage |

Git Status Symbols

The git status section follows Starship conventions:

Ahead / Behind

| Symbol | Meaning | | ------ | ------- | | ⇡N | Ahead of remote by N commits | | ⇣N | Behind remote by N commits | | ⇕N/M | Diverged — ahead by N, behind by M |

File Status

Displayed inside [...] brackets. Multiple symbols can appear simultaneously.

| Symbol | Meaning | | ------ | ------- | | = | Merge conflicts exist | | + | Staged changes (added to index) | | ! | Modified files (unstaged) | | » | Renamed files | | ✘ | Deleted files | | ? | Untracked files | | $ | Stashed changes |

Examples

| Output | Meaning | | ------ | ------- | | main | Clean, up to date | | main ⇡2 | 2 commits ahead of remote | | main ⇣1 | 1 commit behind remote | | main ⇕3/1 | 3 ahead, 1 behind (diverged) | | main [!?] | Has modified and untracked files | | main ⇡1 [+!?$] | 1 ahead, with staged, modified, untracked, and stashed changes | | main [=+!»✘?$] | All status types present |

License

ISC