starship-claude

starship-claude

_Use Starship for your claude code status line._

Quick Start

Run each of the following commands in claude _one at a time_.

Then run the setup wizard:

The wizard is just instructions to claude that will help with setup:

1. Check if starship is installed (offers to install if missing)
2. Detect existing configuration and ask what to do
3. Ask about Nerd Font support
4. Let you choose a color palette
5. Let you choose a prompt style
6. Install the script and generate your config
7. Update your Claude Code settings
8. Verify everything works

Manual Install

You'll need starship to render the statusline:

You'll probably want a Nerd Font (optional) for the robot icons.

When you're ready to install, run these in your terminal (not in claude):

Add the statusline in your Claude Code settings (~/.claude/settings.json):

Run it directly to test it out but you'll need to grab a test fixture JSON file.

My Favorite Feature: Context Window Progress Bar

Show progress bars for context usage percentages in terminals like Ghostty. (I love it!)

We use [Dex Horthy's "dumb zone" (video)][dumb-zone] to start warning at 40%.

- Progress bar scales for 80% compaction.
  - 0-40%: Normal - You're good.
  - 40-60%: Warning - Reset if it's not going well.
  - 60%+: Error - Compacting soon...

Warning does not mean stop, but be aware of your context usage.

This doesn't work in tmux even if you are using Ghostty.
Let me know if you find a workaround.

Customize

Add these options to the ~/.claude/settings.json if you want do things differently.

Running Tests

Install BATS and run tests:

License

MIT License © 2026 Martin Emde