A Zsh prompt for Astronauts.
Spaceship is a minimalistic, powerful and extremely customizable Zsh prompt. It combines everything you may need for convenient work, without unnecessary complications, like a real spaceship.
Currently it shows:
- Clever hostname and username displaying.
- Prompt character turns red if the last command exits with non-zero code.
- Current Git branch and rich repo status:
?
โ untracked changes;+
โ uncommitted changes in the index;!
โ unstaged changes;ยป
โ renamed files;โ
โ deleted files;$
โ stashed changes;=
โ unmerged changes;โก
โ ahead of remote branch;โฃ
โ behind of remote branch;โ
โ diverged changes.
- Current Mercurial bookmark/branch and rich repo status:
?
โ untracked changes;+
โ uncommitted changes in the index;!
โ unstaged changes;โ
โ deleted files;
- Indicator for jobs in the background (
โฆ
). - Current Node.js version, through nvm/nodenv/n (
โฌข
). - Current Ruby version, through rvm/rbenv/chruby/asdf (
๐
). - Current Elixir version, through kiex/exenv/elixir (
๐ง
). - Current Swift version, through swiftenv (
๐ฆ
). - Current Xcode version, through xenv (
๐
). - Current Go version (
๐น
). - Current PHP version (
๐
). - Current Rust version (
๐ฅ
). - Current version of Haskell GHC Compiler, defined in stack.yaml file (
ฮป
). - Current Julia version (
เฎ
). - Current Docker version and connected machine (
๐ณ
). - Current Amazon Web Services (AWS) profile (
โ๏ธ
) (Using named profiles). - Current Python virtualenv.
- Current Conda virtualenv (
๐
). - Current Python pyenv (
๐
). - Current .NET SDK version, through dotnet-cli (
.NET
). - Current Ember.js version, through ember-cli (
๐น
). - Current Kubectl context (
โธ๏ธ
). - Package version, if there's is a package in current directory (
๐ฆ
). - Current battery level and status:
โก
- charging;โฃ
- discharging;โข
- fully charged.
- Current Vi-mode mode (with handy aliases for temporarily enabling).
- Optional exit-code of last command (how to enable).
- Optional time stamps 12/24hr in format (how to enable).
- Execution time of the last command if it exceeds the set threshold.
Want more features? Please, open an issue or send pull request.
You can find more examples with different color schemes in Screenshots wiki-page.
For correct work you will first need:
zsh
(v5.2 or recent) must be installed.- Powerline Font must be installed and used in your terminal.
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.
๐ก Tip: Update Spaceship to new versions as any other package.
Clone this repo:
git clone https://github.com/denysdovhan/spaceship-prompt.git "$ZSH_CUSTOM/themes/spaceship-prompt"
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
.
- Follow prezto-contrib#usage to clone
prezto-contrib
to the proper location. - Enable the
contrib-prompt
module (before theprompt
module). - Set
zstyle ':prezto:module:prompt' theme 'spaceship'
in your.zpreztorc
.
Add the following snippet in your ~/.zshrc
:
antigen theme https://github.com/denysdovhan/spaceship-prompt spaceship
Update your .zshrc
file with the following line:
antibody bundle denysdovhan/spaceship-prompt
Add the following line to your ~/.zshrc
where you're adding your other Zsh plugins:
zgen load denysdovhan/spaceship-prompt spaceship
Use this command in your .zshrc
to load Spaceship as prompt theme:
zplug denysdovhan/spaceship-prompt, use:spaceship.zsh, from:github, as:theme
Install the latest master from the AUR package spaceship-prompt-git
:
git clone https://aur.archlinux.org/spaceship-prompt-git.git
cd spaceship-prompt-git
makepkg -si
If you have problems with approches above, follow these instructions:
- Clone this repo
git clone https://github.com/denysdovhan/spaceship-prompt.git
- Symlink
spaceship.zsh
to somewhere in$fpath
asprompt_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=( "$HOME/.zfunctions" $fpath )
Then install the theme like this:
$ ln -sf "$PWD/spaceship.zsh" "$HOME/.zfunctions/prompt_spaceship_setup"
For initializing prompt system add this to your .zshrc
:
# .zshrc
autoload -U promptinit; promptinit
prompt spaceship
Spaceship works well out of the box, but you can customize almost everything if you want.
- Options โ Tweak section's behavior with tons of options.
- API โ Define a custom section that will do exactly what you want.
You have ability to customize or disable specific elements of Spaceship. All options must be overridden in your .zshrc
file after the theme.
Also, take a look at popular option presets or share your own configuration on Presets wiki page.
Have a trouble? Take a look at out Troubleshooting page.
Still struggling? Please, file an issue, describe your problem and we will gladly help you.
![]() |
![]() |
![]() |
---|---|---|
Denys Dovhan | Salmanul Farzy | Maxim Baz |
Hi! I work on this project in my spare time, beside my primary job. I hope enjoy using Spaceship, and if you do, please, buy me a cup of tea โ๏ธ.
Credit/Debit card | Bitcoin | Ethereum |
---|---|---|
Donate with LiqPay | 1FrPrQb6ACTkbSBAz9PduJWrDFfq41Ggb4 |
0x6aF39C917359897ae6969Ad682C14110afe1a0a1 |
![]() |
![]() |
![]() |
I would appreciate your support! Thank you!
MIT ยฉ Denys Dovhan