FIZSH(1)

📦
version 1.0.9 · 2 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

🦋 fizsh — okay bestie, lemme put you ON 🦋

fizsh is, and I cannot stress this enough, a user friendly front end to zsh. That's the whole vibe. That's the assignment. 💅

✨ SYNOPSIS ✨

fizsh [OPTIONS] ... [ARGUMENTS] ...

🌸 DESCRIPTION 🌸

So here's the tea, bestie. fizsh gives zsh two things it did not have before, and honestly? It ate.

  • interactive syntax-highlighting 🔥
  • a MATLAB-like history-search 🔍

The whole goal is that fizsh look and feel similar to fish. That's the aesthetic. That's the mood board. 🐟

But here's the distinguishing feature, the main character moment, the reason she's built different: fizsh can handle Bourne compatible syntax. Why? Because fizsh is a front end to zsh, and zsh knows how to do that. Fish? Fish does not handle Bourne compatible syntax. Not a read, just a fact. 💀

🎀 CONFIGURATION 🎀

Okay so where does she keep her stuff:

  • "$HOME/.fizsh/" is the directory where fizsh keeps its local configuration files. 🏠
  • "$HOME/.fizsh/.fizshrc" is the user's local startup script. This is where you drop your local customizations, like aliases and functions. It allows the same syntax as "$HOME/.zshrc" under zsh, so no new language to learn, you're welcome. 💖
  • "$HOME/.fizsh/.fizsh_history" is the name of fizsh's history file. 📜

The other files in "$HOME/.fizsh" get installed when the user runs /usr/bin/fizsh for the first time. Heads up though: those files are automatically overwritten after installing a newer version of Fizsh. 😭 So if you went feral customizing them, that's on you to back up.

Good news: the user may call the function fizsh-reinstall to force a reinstallation of their local configuration files. 🫶

⭐ what fizsh sets that plain zsh doesn't ⭐

Compared to the default configuration of zsh, fizsh additionally sets these options:

  • append_history
  • inc_append_history
  • hist_ignore_all_dups
  • hist_reduce_blanks
  • hist_ignore_space
  • interactive_comments
  • correct
  • no_beep
  • prompt_subst

That's nine little gifts. Iconic of her honestly. 👑

For further configuration details consult zsh's man pages. 📖

💅 OPTIONS 💅

Fizsh is usually invoked without options and without command-line arguments. Lowkey she just wants to be launched, no notes. 🙈

The only supported command-line options are --version, --help, --login, and the shorthands for these commands are -v, -h, -l respectively. That's it. That's the whole list.

  • --version, -v — yields fizsh's version number. 🔢
  • --help, -h — causes fizsh to print brief usage information. 📋
  • --login, -l — causes fizsh to run as a login shell. 🔑
Not me about to warn you: if invoked with other command-line options and/or arguments, fizsh will silently revert to zsh. No error, no drama, she just leaves. 🌫️

💀 BUGS 💀

There are no known bugs at the moment. Slay, no cap, fr fr. ✨

Bug reports, bug fixes and other comments are welcome. Come thru, the group chat is open. 🫶

🌈 NOTES 🌈

Fizsh will run as a login shell if:

  1. it is invoked with the -l, or
  2. it is started by the login program.

And here's the detail you need for your $0 lore:

  • If fizsh is run as a login shell, $0 will be set to -fizsh.
  • $0 will be fizsh otherwise.

MATLAB is a registered trademark of The MathWorks, Inc. — gotta give credit where credit is due, bestie. ⚖️

👑 AUTHOR 👑

Guido van Steen, based on work by the "zsh-syntax-highlighting contributors" and the contributors to "zsh-history-substring-search". 🧚

The author also gratefully acknowledges http://www.zsh.org/mla/users/2011/msg00734.html. 📬

🔍 SEE ALSO 🔍

okay and that's the whole page, you're officially educated 🌸 fizsh 1.0.9, dated 2017-07-31 — yes she's been around, she's a vintage queen, and she still eats. Go forth and shell responsibly. 💖🎀🦋

📦 where this page comes from