Skip to content
๐Ÿš€๐ŸŸ A Fish Shell prompt for Astronauts
Branch: master
Clone or download
semantic-release-bot chore(release): 2.6.1 [skip ci]
## [2.6.1](v2.6.0...v2.6.1) (2019-07-01)

### Bug Fixes

* correct incorrectly named config options ([#198](#198)) ([85f9ef5](85f9ef5))
Latest commit dc43ac2 Jul 1, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix lingering fisherman mention Oct 13, 2018
docs fix: correct incorrectly named config options (#198) Jul 1, 2019
functions fix: correct incorrectly named config options (#198) Jul 1, 2019
images Center title and links in README.md (#62) Sep 2, 2018
scripts fix: remove git add from version script Dec 28, 2018
tests fix: correct incorrectly named config options (#198) Jul 1, 2019
.all-contributorsrc docs: add halostatue as a contributor (#195) Jun 19, 2019
.editorconfig Add documentation for spacefish API (#54) Jul 31, 2018
.gitignore Add gitbook publishing (#15) Feb 28, 2018
.travis.yml fix: fix bugs caused by the 3.0 release of fish (#128) Jan 2, 2019
CHANGELOG.md chore(release): 2.6.1 [skip ci] Jul 1, 2019
CONTRIBUTING.md Add All Contributors to the spacefish README.md (#114) Nov 26, 2018
LICENSE Initial commit Feb 1, 2018
README.md docs: add halostatue as a contributor (#195) Jun 19, 2019
SUMMARY.md Add gitbook publishing (#15) Feb 28, 2018
book.json Swim towards v1.0 (#52) Sep 5, 2018
fish_mode_prompt.fish Hide kubecontext outside of kube project (#122) Dec 3, 2018
fish_prompt.fish chore(release): 2.6.1 [skip ci] Jul 1, 2019
fish_right_prompt.fish Implements right prompt support (#101) Nov 16, 2018
package-lock.json
package.json feat: Add elixir section (#190) Jun 19, 2019

README.md

spacefish fish shell theme

Spacefish ๐Ÿš€๐ŸŸ

Fish Shell prompt for Astronauts.

Mac OSX & Linux CI Status Fish Version GitHub License

Built with โค๏ธŽ by Matan Kushner and contributors
A port of Spaceship ZSH by Denys Dovhan

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

Spaceship with Hyper and One Dark

Vist Troubleshooting for instructions to recreate this terminal setup.

Features

  • Clever hostname and username displaying.
  • Indicator if user is root.
  • 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.
  • Indicator for jobs in the background (โœฆ).
  • Current Node.js version, through nvm/nodenv/n (โฌข).
  • Current Docker version and connected machine (๐Ÿณ).
  • Current Ruby version, through rvm/rbenv/chruby/asdf (๐Ÿ’Ž).
  • Current Go version (๐Ÿน).
  • Current PHP version (๐Ÿ˜).
  • Current Rust version (๐—ฅ).
  • Current version of Haskell GHC Compiler, defined in stack.yaml file (ฮป).
  • Current Julia version (เฎƒ).
  • Current Amazon Web Services (AWS) profile (โ˜๏ธ) (Using named profiles).
  • Current Python virtualenv.
  • Current Conda version (๐Ÿ…’).
  • Current Elixir Version (๐Ÿ’ง).
  • Current Python pyenv (๐Ÿ).
  • Current .NET SDK version, through dotnet-cli (.NET).
  • Current Kubectl context (โ˜ธ๏ธ).
  • Package version, if there is a package in current directory (๐Ÿ“ฆ).
  • Current battery level and status:
    • โ‡ก - charging;
    • โ‡ฃ - discharging;
    • โ€ข - fully charged.
  • Current Vi-mode mode.
  • Optional exit-code of last command.
  • Optional time stamps 12/24hr in format.
  • Execution time of the last command if it exceeds 5 seconds.

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

Requirements

To get spacefish working correctly, you will need:

Installation

Fisher

$ fisher add matchai/spacefish

Oh My Fish!

$ omf install spacefish

Customization

Spacefish works really well out of the box, but you can customize your fish to your heart's content!

  • 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.

Contributors

Thanks goes to these wonderful people (emoji key):

Matan Kushner
Matan Kushner

๐Ÿ› ๐Ÿ’ป ๐Ÿ“– ๐Ÿ‘€ โš ๏ธ ๐Ÿ”ง ๐ŸŽจ
Tiffany Le-Nguyen
Tiffany Le-Nguyen

๐Ÿ› ๐Ÿ’ป ๐Ÿ“– ๐Ÿ‘€ โš ๏ธ
Snuggle
Snuggle

๐Ÿ› ๐Ÿ’ป ๐Ÿ“– ๐Ÿ‘€ โš ๏ธ
Jaskaran Bindra
Jaskaran Bindra

๐Ÿ’ป ๐Ÿ“– โš ๏ธ
Konstantin Labun
Konstantin Labun

๐Ÿ’ป ๐Ÿ“– โš ๏ธ
Kyle Holzinger
Kyle Holzinger

๐Ÿ’ป ๐Ÿ“–
Salmanul Farzy
Salmanul Farzy

๐Ÿ’ป ๐Ÿ‘€
owais
owais

๐Ÿ’ป ๐Ÿ“– โš ๏ธ
Samantha Enders
Samantha Enders

๐Ÿ’ป ๐Ÿ“– โš ๏ธ
Evan Relf
Evan Relf

๐Ÿ’ป ๐Ÿ“–
Jason Etcovitch
Jason Etcovitch

๐Ÿ’ป ๐Ÿ“–
hrvoj3e
hrvoj3e

๐Ÿ› ๐Ÿ’ป
Michael Newman
Michael Newman

๐Ÿ› ๐Ÿ’ป ๐Ÿ“– โš ๏ธ
Konrad
Konrad

๐Ÿ›
Will Neville
Will Neville

๐Ÿ›
Daniel Trautmann
Daniel Trautmann

๐Ÿ’ป
Jonas ร–hlander
Jonas ร–hlander

๐Ÿ›
lindsay
lindsay

๐Ÿ“–
Brad
Brad

๐Ÿ’ป
Nam Nguyen
Nam Nguyen

๐Ÿ’ป
Austin Ziegler
Austin Ziegler

๐Ÿ‘€

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT ยฉ Matan Kushner

You canโ€™t perform that action at this time.