Skip to content

Getting Started


  • zsh (v5.2 or recent) must be installed.
  • Powerline Font must be installed and used in your terminal (for example, switch font to Fira Code).


Now that the requirements are satisfied, you can install Spaceship via any of the following approaches:


If you're using any plugin manager, like Oh-My-Zsh, zplug, antigen or other, this might not be the best way to install Spaceship for you.

This is way to install Spaceship if you don't use any tool for managing Zsh plugins.

  • Clone this repo git clone --depth=1
  • Symlink spaceship.zsh to somewhere in $fpath as prompt_spaceship_setup.
  • Initialize prompt system and choose spaceship.


Run echo $fpath to see possible location and link spaceship.zsh there, like:

$ ln -sf "$PWD/spaceship.zsh" "/usr/local/share/zsh/site-functions/prompt_spaceship_setup"

For a user-specific installation, simply add a directory to $fpath for that user in .zshrc:

fpath=( "${ZDOTDIR:-$HOME}/.zfunctions" $fpath )

Then install the theme like this:

$ ln -sf "$PWD/spaceship.zsh" "${ZDOTDIR:-$HOME}/.zfunctions/prompt_spaceship_setup"

For initializing prompt system add this to your .zshrc:

# .zshrc
autoload -U promptinit; promptinit
prompt spaceship
brew install spaceship

You can also add the following to your Brewfile:

brew "spaceship"

Clone this repo:

git clone "$ZSH_CUSTOM/themes/spaceship-prompt" --depth=1

Symlink spaceship.zsh-theme to your oh-my-zsh custom themes directory:

ln -s "$ZSH_CUSTOM/themes/spaceship-prompt/spaceship.zsh-theme" "$ZSH_CUSTOM/themes/spaceship.zsh-theme"

Set ZSH_THEME="spaceship" in your .zshrc.

npm install -g spaceship-prompt

Done. This command should link spaceship.zsh as prompt_spaceship_setup to your $fpath and set prompt spaceship in .zshrc. Just reload your terminal.


Update Spaceship to new versions as you would any other package.

  • Follow prezto-contrib#usage to clone prezto-contrib to the proper location.
  • Enable the contrib-prompt module (before the prompt module).
  • Set zstyle ':prezto:module:prompt' theme 'spaceship' in your .zpreztorc.

Add zmodule spaceship-prompt/spaceship-prompt --name spaceship to your .zimrc and run zimfw install.

Add the following snippet in your .zshrc:

antigen theme spaceship-prompt/spaceship-prompt

Update your .zshrc file with the following line:

antibody bundle spaceship-prompt/spaceship-prompt

Add the following line to your .zshrc where you're adding your other Zsh plugins:

zinit light spaceship-prompt/spaceship-prompt

Add the following line to your .zshrc where you're adding your other Zsh plugins:

zgen load spaceship-prompt/spaceship-prompt spaceship

Use this command in your .zshrc to load Spaceship as prompt theme:

zplug "spaceship-prompt/spaceship-prompt", use:spaceship.zsh, from:github, as:theme

Install the latest master from the AUR package spaceship-prompt-git:

git clone --depth=1
cd spaceship-prompt-git
makepkg -si


You've made it! You've installed Spaceship on your machine!

What's next? Spaceship has reasonable defaults, but you might want to adjust them to your needs. Visit our Options page to learn how to configure your Spaceship.


Follow our Twitter to keep yourself updated about new features, improvements, and bugfixes.


Having trouble? Take a look at out Troubleshooting page.

Still struggling? Please, file an issue, describe your problem and we will gladly help you.

Back to top