/spacefish

๐Ÿš€๐ŸŸ A fish port of spaceship

Primary LanguageShellMIT LicenseMIT

spacefish fish shell theme

๐Ÿš€๐ŸŸ 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.

Preview

Spaceship with Hyper and One Dark

Features

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

Upcoming features

  • Displaying hostname/username
  • Indicator if user is root
  • Indicator for jobs in the background (โœฆ).
  • Current Node.js version, through nvm/nodenv/n (โฌข).
  • Current Ruby version, through rvm/rbenv/chruby (๐Ÿ’Ž).
  • Current Python pyenv (๐Ÿ).
  • Package version, if there's is a package in current directory (๐Ÿ“ฆ).
  • Current battery level and status:
    • โ‡ก - charging;
    • โ‡ฃ - discharging;
    • โ€ข - fully charged.
  • Optional exit-code of last command.
  • Optional time stamps 12/24hr in format.

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

Requirements

To get spacefish working correctly you will need:

Installation

$ fisher matchai/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 ability to customize or disable specific elements of Spacefish. All options must be overridden in your config.fish.

License

MIT ยฉ Matan Kushner