🚀🐟 Spacefish

A Fish Shell prompt for Astronauts.

Spacefish is a Fish Shell port of Spaceship; the minimalistic, powerful and extremely customizable Zsh prompt. It combines everything you may need for convenient work, without unnecessary complications, like a real spacefish.

Features

Indicator if user is root
Prompt character turns red if the last command exits with non-zero code.
Execution time of the last command if it exceeds 5 seconds.
Current Node.js version, through nvm/nodenv/node (⬢).
Current Ruby version, through rvm/rbenv (💎).
Package version, if there's is a package in current directory (📦).
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 chages.
Current battery level and status:
- ⇡ - charging;
- ⇣ - discharging;
- • - fully charged.

Upcoming features

Displaying hostname/username
Indicator for jobs in the background (✦).
Current Python pyenv (🐍).
Current Ruby version, through chruby/asdf (💎).
Optional exit-code of last command.
Optional time stamps 12/24hr in format.

Want more features? Please, open an issue or send pull request.

Preview

Requirements

To get spacefish working correctly you will need:

fish (v2.7.0 or newer)
Powerline Font must be installed and enabled in your terminal.

Installation

Fisherman

$ fisher matchai/spacefish

Oh My Fish!

$ omf install spacefish

Customization

Spacefish works well out of the box, but you can customize almost everything if you want.

Options — Tweak section's behavior with tons of options.

You have the ability to customize or disable specific elements of Spacefish. All options must be overridden in your config.fish.

Troubleshooting

Having issues? Take a look at our Troubleshooting page.

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

tiffafoo / spacefish