Starship is a fast, cross-shell prompt configured by a single starship.toml — around a hundred modules, each with its own format strings and style strings.
Tuning that file normally means editing it, reloading your shell, and looking at the result. This closes the loop: you edit visually, the prompt re-renders instantly against a simulated shell environment, and you export the exact starship.toml that reproduces it. The editing happens entirely in your browser: your config is never uploaded, and the site itself carries no tracking code — visits are counted at the edge, without cookies.
New to the configuration language? Start with the guides, or look up examples and key options in the module reference.
An unaffiliated community tool, not endorsed by the Starship project — which lives at github.com/starship/starship.
What the prompt contains, and in what order. Reorder, remove, recolour, or add pieces here. Drag the handles to reorder; group a run of related modules so they share one style.
Format string guideStyle string guide
Rendered flush against the right edge. Not supported by every shell.
What the shell would report about this machine and directory. It decides which modules appear at all — a language module only shows up when its tool and a matching file are both here.
starship prints branch:upstream when the two differ, so set both to see a single name.
A language module only appears when its tool is installed and the directory has a matching file.
Set a context first — starship takes the namespace from it, and shows nothing without one.
Read by the env_var module and by anything using detect_env_vars.
A palette pairs a reusable name with a colour. To make a style follow it, choose the name — for example peach instead of #fab387. Changing the entry then updates every style that uses peach.
Solid chips have matching entries in catppuccin_mocha; dashed chips do not. Copying a dashed chip creates an entry with the same text as a temporary name, without changing the style.
A palette name changes only styles that use it. Copying or renaming a palette entry does not update existing styles; choose that name in their style pickers.