Skip to content
Snippets Groups Projects
Select Git revision
  • awit default protected
1 result
Compare
Name Last commit Last update
fn
.gitignore
LICENSE
README.md
tips.md
zshenv
zshrc
README.md

IDMS Zsh Config

Warning

  • This is a hard-fork and a work in progress.

It may not work as intended, and it is not backward compatible with Zsh for Humans.

For the original project please see: https://github.com/romkatv/zsh4humans

Introduction

A turnkey configuration for Zsh that aims to work really well out of the box. It combines the best Zsh plugins into a coherent whole that feels like a finished product rather than a DIY starter kit.

If you want a great shell that just works, this project is for you.

This fork of Zsh for Humans is smaller, more limited (no SSH settings), and focused on being installed in /etc.

Table of contents

Features

  • Powerful POSIX-based shell pre-configured to work great out of the box.
  • Syntax highlighting for the command line.
  • Autosuggestions for commands based on command history.
  • Command prompt configurable through a builtin configuration wizard.
  • Command completions and history searchable with fzf.
  • Super fast. No lag when you open a new tab in the terminal or run a command.

Installation

TODO: pacman installation instructions

Try it in Docker

Try Zsh for Humans in a Docker container. You can safely install additional software and make any changes to the file system. Once you exit Zsh, the image is deleted.

TODO: Arch Linux installation instructions

Caveats

Zsh for Humans is not a good choice for users who prefer vi bindings in their shell.

Zsh for Humans has very little documentation (TODO). There is no list of configuration options (TODO) it recognizes and no description of what those options do (TODO).

Usage

If you've used Zsh, Bash or Fish before, Zsh for Humans should feel familiar. For the most part everything works as you would expect.

Accepting autosuggestions

All key bindings that move the cursor can accept command autosuggestions. For example, moving the cursor one word to the right will accept that word from the autosuggestion. The whole autosuggestion can be accepted without moving the cursor with Alt+M/Option+M.

Autosuggestions in Zsh for Humans are provided by zsh-autosuggestions. See its homepage for more information.

Completing commands

When completing with Tab, suggestions come from completion functions. For most commands completion functions are provided by Zsh proper. Additional completion functions are contributed by zsh-completions. See its homepage for the list of commands it supports.

Ambiguous completions automatically start fzf. Accept the desired completion with Enter. You can also select more than one completion with Ctrl+Space or all of them with Ctrl+A.

Searching command history

Up and Down keys fetch commands from history that contain what you've already typed on the command line. For example, if you press Up after typing grep, you'll see the last executed command that contains grep.

Ctrl+R starts fzf to search over history.

Interactive search with fzf

Several UI elements in Zsh for Humans use fzf to quickly select an item from a potentially large list of candidates. You can type multiple search terms delimited by spaces. For example:

^music .mp3$ sbtrkt !fire
Token Match type Description
wild substring Items with the substring wild
^music prefix Items that start with music
.mp3$ suffix Items that end with .mp3
!wild inverse substring Items without the substring wild
!^music inverse prefix Items that do not start with music
!.mp3$ inverse suffix Items that do not end with .mp3

A single bar (|) acts as an OR operator. For example, the following query matches entries that start with core and end with either go, rb, or py.

^core go$ | rb$ | py$

See fzf homepage for more information.

Customization

You can (and should) edit ~/.zshrc to customize your shell.

It's a very good idea to read through /etc/zsh/zshrc to see which customization options are in there and to flip some of them to your liking in your ~/.zshrc.

The default /etc/zsh/zshrc contains the following types of customizations that should serve as examples:

  • Export environment variables.
  • Extend PATH.
  • Define aliases.
  • Add flags to existing aliases.
  • Define functions.
  • Source additional local files.
  • Load Oh My Zsh plugins.
  • Clone and load external Zsh plugins.
  • Set shell options.
  • Autoload functions.
  • Change key bindings.

Customizing prompt

Prompt in Zsh for Humans is provided by Powerlevel10k. Run p10k configure to access its interactive configuration wizard. Further customization can be done by editing ~/.p10k*.zsh files. There can be more than one configuration file to account for terminals with limited capabilities. Most users will ever only see ~/.p10k.zsh. When in doubt, consult $POWERLEVEL9K_CONFIG_FILE. This parameter is set by Zsh for Humans and it always points to the Powerlevel10k config file currently in use.

See Powerlevel10k homepage for more information.

Customizing appearance

Different parts of Zsh for Humans UI are rendered by different projects.

Zsh for Humans

Everything within the highlighted areas on the screenshot is prompt. It is produced by Powerlevel10k. See Customizing prompt.

The listing of files produced by ls command is colored by ls itself. Different commands have different ways of customizing their output, and even different version of ls have different flags and environment variables related to colors. Zsh for Humans enables colored output for common commands such as ls and grep. For further customization consult documentation of the respective command.

echo hello is the current command being typed. Syntax highlighting for it is provided by zsh-syntax-highlighting. See its homepage for documentation on how to customize it.

After echo hello you can see world in grey. This is not a part of the command, so pressing Enter will print only hello but not world. The latter is an autosuggestion provided by zsh-autosuggestions that you can accept in part or in full. It comes from command history and it's a great productivity booster. See zsh-autosuggestions homepage for more information.

Last but not least, your terminal has a say about the appearance of everything that runs within it. The base colors, numbered from 0 to 15, can look differently in different terminals and even in the same terminal with different settings. Most modern terminals support themes, color palettes or color schemes that allow you to quickly change base colors. If colors in your terminal look unpleasant, try a different theme. Note that colors with codes above 15, as well as colors specified as RGB triplets, don't get affected by terminal themes. They look the same everywhere.

Additional Zsh startup files

When you start Zsh, it automatically sources /etc/zsh/zshenv and /etc/zsh/zshrc. The former bootstraps Zsh for Humans, the latter is the interactive Zsh config. It is strongly recommended to keep all shell customization and configuration (including exported environment variables such as PATH) in ~/.zshrc or in files sourced from ~/.zshrc.

Zsh supports several additional startup files with complex rules governing when each file is sourced. The additional startup files are ~/.zprofile, ~/.zlogin and ~/.zlogout. Do not create these files unless you are absolutely certain you need them.

Updating

TODO: pacman installation instructions

Uninstalling

TODO: pacman uninstall instructions

  1. Delete or replace ~/.zshenv and ~/.zshrc. If you had these files prior to the installation of Zsh for Humans ...

  2. Restart your terminal. Restarting zsh is not enough.

  3. Delete Zsh for Humans cache:

    rm -rf -- "${XDG_CACHE_HOME:-$HOME/.cache}/zsh4humans/v5"

Advanced configuration tips

See the tips document.