Installing stellar

Get the stellar binary onto your machine, then point it at a theme from the hub.

This installs the binary to ~/.local/bin. Check what the script does here.

Prefer copies over symlinks?

stellar applies themes by symlinking starship.toml — set STELLAR_APPLY_MODE=copy if you'd rather have it copy the file instead.

This installs the binary to %LOCALAPPDATA%\stellar\bin and adds it to your PATH. Check what the script does here.

Windows applies themes by copying

Symlinks on Windows need Developer Mode or admin privileges, so on Windows stellar copies the theme file over starship.toml instead of symlinking it. This means there's no hot-reload while editing local themes — re-run stellar apply after making changes. See how it works for details.

Verify the install

Shell completions

stellar can generate completions for its commands as well as the theme names in your local cache, for your shell of choice.

Completing themes you haven't downloaded yet

Completion only suggests themes from your local cache, so it's instant and works offline. Set STELLAR_COMPLETION_ONLINE=1 to have it suggest hub themes too — that adds up to ~2 seconds of network lookup per completion, and falls back to local-only when the hub can't be reached.

Bash

Or source it directly from your .bashrc:

Zsh

Fish

PowerShell

Add this to your $PROFILE:

Next steps

Browse themesFind your next prompt on the stellar hub.CommandsEvery stellar command with examples: apply, preview, remove and more.