Zsh
prompt
Spaceship is a minimalistic, powerful and extremely customizable Zsh prompt. Prompt is what you see when you type a command. It can show a lot of useful tips, saving your time and making the user experience smooth and pleasant. It combines everything you may need for convenient work, without unnecessary complications, like a real spaceship.
Visit Frequently Asked Question for similar setup and find more examples with different color schemes in Screenshots wiki-page.
Here are some sneak peeks of what Spaceship can show:
✦
Want more features? Please, open an issue or send a pull request.
Before we begin, let's make sure you have the following installed:
echo $ZSH_VERSION #> 5.8.1
echo -e "\xee\x82\xa0" #>
Here are a few popular methods to install Spaceship. Select the one you use from the list below:
Homebrew Installing Spaceship via Homebrew is a simple command:Add prompt initialization to your .zshrc
:
echo "source $(brew --prefix)/opt/spaceship/spaceship.zsh" >>! ~/.zshrcOh-My-Zsh Clone this repo:
git clone https://github.com/spaceship-prompt/spaceship-prompt.git "$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
This command will download Spaceship. It will also ask you to source Spaceship in your ~/.zshrc
file.
prezto-contrib
to the proper location.contrib-prompt
module (before the prompt
module).zstyle ':prezto:module:prompt' theme 'spaceship'
in your .zpreztorc
.zmodule spaceship-prompt/spaceship-prompt --name spaceship --no-submodules
Then, install Spaceship:
antigen Add the following snippet in your `.zshrc`:antigen theme spaceship-prompt/spaceship-promptantibody Update your `.zshrc` file with the following line:
antibody bundle spaceship-prompt/spaceship-promptzinit Add the following line to your `.zshrc` where you're adding your other Zsh plugins:
zinit light spaceship-prompt/spaceship-promptzgen Add the following line to your `.zshrc` where you're adding your other Zsh plugins:
zgen load spaceship-prompt/spaceship-prompt spaceshipzplug Use this command in your `.zshrc` to load Spaceship as prompt theme:
zplug "spaceship-prompt/spaceship-prompt", use:spaceship.zsh, from:github, as:themesheldon Add the following to your `plugins.toml` file (open it with `sheldon edit`):
[plugins.spaceship] github = "spaceship-prompt/spaceship-prompt"
Or run the following to automatically add it:
sheldon add spaceship --github spaceship-prompt/spaceship-promptArch
Install the latest release from the AUR package spaceship-prompt:
git clone https://aur.archlinux.org/spaceship-prompt.git
cd spaceship-prompt
makepkg -si
or using yay
:
Also there is an unmaintained git package spaceship-prompt-git.
ManualIf none of the above methods works for you, you can install Spaceship manually.
$HOME/.zsh/spaceship
.~/.zshrc
.mkdir -p "$HOME/.zsh" git clone --depth=1 https://github.com/spaceship-prompt/spaceship-prompt.git "$HOME/.zsh/spaceship"
For initializing prompt system, add this to your .zshrc
:
source "$HOME/.zsh/spaceship/spaceship.zsh"
Spaceship works well out of the box, but you can customize almost everything if you want.
Additionally, join our community in Discord and follow our Twitter for updates.
We're glad to accept contributions from developers of all skill levels! If you are interested in contributing to Spaceship, please take a look at our Contribution Guide for more details. If you're looking for an easy way into the project, take one of the issues with good first issue label.
If you are fluent in any other language besides English, we greatly appreciate any help with translating our documentation in other languages. If you would like to help, join the team of translators on our Crowdin.
If you're interested in helping other people, answer questions asked by other users of Spaceship and help to solve their issues. Additionally, join our Discord to discuss Spaceship and help people who need help.
If you really enjoy this project, you can contribute financially. Any contribution is highly appreciated, even the smallest one. There are several ways to donate:
0x5C9496De5E51D48daf28354DC04d8f9D33955559
bc1q5ezjvpgftmx42f9qgdf5lscjz43uh4jf02uvje
Find answers on our troubleshooting page or get help from our community.
Issues • Discussions • Discord
Still struggling? Please, file an issue, describe your problem, and we will gladly help you.
Here's a list of related projects that have been inspired by Spaceship ZSH.
MIT © Denys Dovhan
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4