The custom statusline shows live session information at the bottom of Claude Code, so you always know your context and spend.
What it shows
- Current git branch and change count
- Context remaining
- Tokens used
- Session and rolling cost (via
ccusage) - Five-hour and weekly limits
- Task progress
How it is installed
During agents setup, the CLI:
- Copies the statusline scripts into
~/.claude/scripts. - Installs
bunandccusageif they are missing. - Runs
bun installinside the scripts directory. - Adds a
statusLineentry to~/.claude/settings.json:
JSON
{
"statusLine": {
"type": "command",
"command": "bun ~/.claude/scripts/statusline/src/index.ts"
}
}
Codex
For Codex, the same information is configured through the status_line
components in ~/.codex/config.toml:
TOML
[tui]
status_line = [
"model-with-reasoning",
"run-state",
"project-name",
"git-branch",
"branch-changes",
"context-remaining",
"used-tokens",
"five-hour-limit",
"weekly-limit",
"task-progress"
]
status_line_use_colors = true