This page aimed to help you fix common problems encountered while using spacefish.

My prompt is filling with errors

Try all of the following troubleshooting steps:

  • Verify that your fish installation is at the latest version

    fish --version
  • Update spacefish with fisher or omf

    fisher add matchai/spacefish
    # or
    omf update spacefish
  • If errors persist, please open an issue

What's the weird symbol beside the git branch?

You need to have a powerline patched font in order to properly display git branch symbol.

What's the weird character in front of a section?

This is not an issue with spacefish. Spacefish uses Unicode symbols to represent SPACESFISH_*_SYMBOL in sections. To solve this problem:

  • Verify your terminal emulator supports Unicode characters with this command:

    # or
    wget -O -
  • Configure your terminal emulator to use UTF-8 character encoding.

In the event that Unicode characters aren't supported, you can replace them with characters that are compatible with your terminal with SPACEFISH_*_SYMBOL options. Check out the Options page for more information.

Why is my prompt slow?

Spacefish may run more slowlyin big repositories since the status checks add up to be expensive operations.

To speed up your prompt, try to reduce the number of unused spacefish sections that are enabled. Spacefish only loads the sections mentioned in SPACEFISH_PROMPT_ORDER. If you think some sections might not be be useful to you, you can disable them by not including their names in the prompt order.

Why do my section icons overlap each other?

overlapping icons

This issue is due to how your terminal emulator renders Unicode 9 characters. To fix this issue:

  • Make sure terminal uses Unicode Version 9 Widths.

In iTerm follow these instructions:

  • Go iTerm → Preferences… (⌘,) → Profiles → Text
  • Check Unicode Version 9 Widths.
  • Reload your terminal's tab.

Why doesn't my prompt look like it does in the preview?


Preview shows a spacefish setup with:

  • Hyper as the terminal emulator.
  • One Dark color theme from Atom editor.
  • Fira Code with with ligatures as primary font (16px size).

My problem wasn't solved

If the above suggestions don't address your problem, feel free to open an issue, describe your problem and we will gladly help you.

results matching ""

    No results matching ""