Skip to content
Back to search

starship-claude

SkillWorks with Claude CodeGitHub

✳ claude statusline via starship

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/martinemde--starship-claude/badge.svg)](/listings/martinemde--starship-claude)

HTML

<a href="/listings/martinemde--starship-claude"><img src="/api/listings/martinemde--starship-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!TIP] > Run each of the following commands in `claude` _one at a time_.

/plugin marketplace add martinemde/starship-claude
/plugin install starship-claude@starship-claude
/reload-plugins

Then run the setup wizard:

/starship

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 36 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "starship-claude",
  3. "owner": {
  4. "name": "Martin Emde",
  5. "email": "me@martinemde.com"
  6. },
  7. "metadata": {
  8. "description": "starship-claude statusline setup wizard",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "starship-claude",
  14. "source": "./plugin",
  15. "description": "Configure starship-claude statusline with customizable palettes and styles",
  16. "version": "1.0.0",
  17. "author": {
  18. "name": "Martin Emde",
  19. "email": "me@martinemde.com"
  20. },
  21. "homepage": "https://github.com/martinemde/starship-claude",
  22. "repository": "https://github.com/martinemde/starship-claude",
  23. "keywords": [
  24. "starship",
  25. "statusline",
  26. "prompt",
  27. "catppuccin",
  28. "gruvbox",
  29. "dracula",
  30. "nord"
  31. ],
  32. "category": "statusline",
  33. "tags": ["starship", "prompt", "customization"]
  34. }
  35. ]
  36. }
README.md · README · 138 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # starship-claude
  2. [![CI](https://github.com/martinemde/starship-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/martinemde/starship-claude/actions/workflows/ci.yml)
  3. ![starship-claude screenshot](screenshot.png)
  4. _Use [Starship](https://starship.rs) for your [`claude` code](https://claude.ai/products/claude-code) status line._
  5. ## Quick Start
  6. > [!TIP]
  7. > Run each of the following commands in `claude` _one at a time_.
  8. ```claude
  9. /plugin marketplace add martinemde/starship-claude
  10. ```
  11. ```claude
  12. /plugin install starship-claude@starship-claude
  13. ```
  14. ```claude
  15. /reload-plugins
  16. ```
  17. Then run the setup wizard:
  18. ```claude
  19. /starship
  20. ```
  21. ![starship-claude setup wizard screenshot](setupwizard.png)
  22. The wizard is just instructions to claude that will help with setup:
  23. 1. Check if starship is installed (offers to install if missing)
  24. 2. Detect existing configuration and ask what to do
  25. 3. Ask about Nerd Font support
  26. 4. Let you choose a color palette
  27. 5. Let you choose a prompt style
  28. 6. Install the script and generate your config
  29. 7. Update your Claude Code settings
  30. 8. Verify everything works
  31. ## Manual Install
  32. You'll need [starship](https://starship.rs/#quick-install) to render the statusline:
  33. ```bash
  34. # If you don't already have starship...
  35. curl -sS https://starship.rs/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 51 on GitHub
  36. ```
  37. You'll probably want a [Nerd Font](https://www.nerdfonts.com/) (optional) for the robot icons.
  38. When you're ready to install, run these in your terminal (not in claude):
  39. ```bash
  40. # Download the script from this repository
  41. mkdir -p ~/.local/bin
  42. curl -fsSL https://raw.githubusercontent.com/martinemde/starship-claude/main/plugin/bin/starship-claude \
  43. -o ~/.local/bin/starship-claude && chmod +x ~/.local/bin/starship-claude
  44. # Get the config file that you can customize
  45. mkdir -p ~/.claude
  46. curl -fsSL https://raw.githubusercontent.com/martinemde/starship-claude/main/plugin/templates/minimal-nerd.toml \
  47. -o ~/.claude/starship.toml
  48. ```
  49. Add the statusline in your Claude Code settings (`~/.claude/settings.json`):
  50. ```jsonc
  51. {
  52. // ... other stuff
  53. "statusLine": {
  54. "type": "command",
  55. "command": "~/.local/bin/starship-claude",
  56. },
  57. }
  58. ```
  59. Run it directly to test it out but you'll need to grab a [test fixture JSON file](https://raw.githubusercontent.com/martinemde/starship-claude/refs/heads/main/test/fixtures/low_cost_session.json).
  60. ```sh
  61. ./plugin/bin/starship-claude < test/fixtures/low_cost_session.json
  62. ```
  63. ## My Favorite Feature: Context Window Progress Bar
  64. Show progress bars for context usage percentages in terminals like Ghostty. (I love it!)
  65. We use [Dex Horthy's "dumb zone" (video)][dumb-zone] to start warning at 40%.
  66. - Progress bar scales for 80% compaction.
  67. - 0-40%: Normal - You're good.
  68. - 40-60%: Warning - Reset if it's not going well.
  69. - 60%+: Error - Compacting soon...
  70. Warning does not mean stop, but be aware of your context usage.
  71. > [!NOTE]
  72. > This doesn't work in tmux even if you are using Ghostty.
  73. > Let me know if you find a workaround.
  74. [dumb-zone]: https://www.youtube.com/watch?v=rmvDxxNubIg 'YouTube: No Vibes Allowed: Solving Hard Problems in Complex Codebases – Dex Horthy, HumanLayer'
  75. ### Customize
  76. Add these options to the `~/.claude/settings.json` if you want do things differently.
  77. ```sh
  78. # custom config file
  79. starship-claude --config ~/.config/starship/claude.toml
  80. # disable terminal context progress bar (maybe it's printing weird characters?)
  81. starship-claude --no-progress
  82. ```
  83. ### Running Tests
  84. Install BATS and run tests:
  85. ```bash
  86. # Install BATS via mise
  87. mise use bats@latest
  88. mise install
  89. # Run all tests
  90. mise exec -- bats test/
  91. # Run specific test file
  92. mise exec -- bats test/model_extraction.bats
  93. ```
  94. ## License
  95. MIT License © 2026 Martin Emde

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.