Zsh

Z shell configuration and customization. Manage plugins, themes, aliases, completions, and shell startup files.

41 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

Config

Shell configuration

10commands

Plugins

Plugin management

10commands

Aliases

Alias management

8commands

Prompt

Prompt customization

10commands

Check Zsh version

$ zsh --version

Display the installed Zsh version

Install Zsh (macOS)

$ brew install zsh

Install Zsh shell using Homebrew on macOS

Set Zsh as default shell

$ chsh -s $(which zsh)

Change the default login shell to Zsh

Enable auto cd

$ setopt AUTO_CD

cd into directory by typing its name

Enable correction

$ setopt CORRECT

Enable command spelling correction

Edit zsh config

$ $EDITOR ~/.zshrc

Open .zshrc in default editor

Enable extended globbing

$ setopt EXTENDED_GLOB

Enable powerful glob patterns

Better history options

$ setopt SHARE_HISTORY HIST_IGNORE_DUPS HIST_IGNORE_SPACE

Enable useful history options

List all options

$ setopt

Show all enabled zsh options

Reload zsh config

$ source ~/.zshrc

Reload .zshrc configuration

Enable option

$ setopt AUTO_CD

Enable a zsh option

Disable option

$ unsetopt AUTO_CD

Disable a zsh option

Show zsh version

$ zsh --version

Display zsh version

Install autosuggestions

$ git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

Install zsh-autosuggestions plugin

Install fzf integration

$ git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf && ~/.fzf/install

Install fzf fuzzy finder with zsh integration

Install Oh My Zsh

$ sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Install Oh My Zsh framework

Update Oh My Zsh

$ omz update

Update Oh My Zsh to latest version

Configure Powerlevel10k

$ p10k configure

Run Powerlevel10k configuration wizard

List plugins

$ ls ~/.oh-my-zsh/plugins

List available Oh My Zsh plugins

Install Powerlevel10k

$ git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Install Powerlevel10k theme

Install syntax highlighting

$ git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Install zsh-syntax-highlighting plugin

Install Zinit

$ bash -c "$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"

Install Zinit plugin manager

Load plugin with Zinit

$ zinit light zsh-users/zsh-autosuggestions

Load a plugin using Zinit

Bypass alias

$ \ls

Run original command, bypass alias

Common useful aliases

$ alias ..='cd ..' ...='cd ../..' ll='ls -la' la='ls -A'

Define common navigation aliases

Create alias

$ alias ll='ls -la'

Create a new alias

Global alias

$ alias -g G='| grep'

Create global alias (works anywhere in command)

List all aliases

$ alias

Show all defined aliases

Remove alias

$ unalias ll

Remove an alias

Suffix alias

$ alias -s txt=code

Open .txt files with code by typing filename

Check alias definition

$ which ll

Show what an alias expands to

Initialize completions

$ autoload -Uz compinit && compinit

Initialize zsh completion system

Menu-style completion

$ zstyle ':completion:*' menu select

Enable menu-style tab completion

History substring search

$ bindkey '^[[A' history-substring-search-up

Search history with up arrow

Show available colors

$ for i in {0..255}; do print -Pn "%K{$i} %k%F{$i}${(l:3::0:)i}%f " ${${(M)$((i%6)):#3}:+$'\n'}; done

Display all 256 terminal colors

Basic prompt

$ PROMPT='%n@%m:%~%# '

Set basic prompt (user@host:dir)

Colored prompt

$ PROMPT='%F{green}%n%f@%F{blue}%m%f:%F{yellow}%~%f%# '

Set colored prompt

Prompt escape codes

$ # %n=user %m=host %~=dir %#=prompt %F{color}=fg %f=reset

Common prompt escape sequences reference

Enable git info in prompt

$ autoload -Uz vcs_info && precmd() { vcs_info }

Enable version control info in prompt

Right-side prompt

$ RPROMPT='%F{cyan}%*%f'

Set right-side prompt (shows time)

Transient prompt setup

$ # In p10k, set POWERLEVEL9K_TRANSIENT_PROMPT=same-dir

Simplify prompt after command execution

Discussion

Loading comments...

Zsh

Z shell configuration and customization. Manage plugins, themes, aliases, completions, and shell startup files.

41 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

Config

Shell configuration

10commands

Plugins

Plugin management

10commands

Aliases

Alias management

8commands

Prompt

Prompt customization

10commands

Check Zsh version

$ zsh --version

Display the installed Zsh version

Install Zsh (macOS)

$ brew install zsh

Install Zsh shell using Homebrew on macOS

Set Zsh as default shell

$ chsh -s $(which zsh)

Change the default login shell to Zsh

Enable auto cd

$ setopt AUTO_CD

cd into directory by typing its name

Enable correction

$ setopt CORRECT

Enable command spelling correction

Edit zsh config

$ $EDITOR ~/.zshrc

Open .zshrc in default editor

Enable extended globbing

$ setopt EXTENDED_GLOB

Enable powerful glob patterns

Better history options

$ setopt SHARE_HISTORY HIST_IGNORE_DUPS HIST_IGNORE_SPACE

Enable useful history options

List all options

$ setopt

Show all enabled zsh options

Reload zsh config

$ source ~/.zshrc

Reload .zshrc configuration

Enable option

$ setopt AUTO_CD

Enable a zsh option

Disable option

$ unsetopt AUTO_CD

Disable a zsh option

Show zsh version

$ zsh --version

Display zsh version

Install autosuggestions

$ git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

Install zsh-autosuggestions plugin

Install fzf integration

$ git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf && ~/.fzf/install

Install fzf fuzzy finder with zsh integration

Install Oh My Zsh

$ sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Install Oh My Zsh framework

Update Oh My Zsh

$ omz update

Update Oh My Zsh to latest version

Configure Powerlevel10k

$ p10k configure

Run Powerlevel10k configuration wizard

List plugins

$ ls ~/.oh-my-zsh/plugins

List available Oh My Zsh plugins

Install Powerlevel10k

$ git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Install Powerlevel10k theme

Install syntax highlighting

$ git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Install zsh-syntax-highlighting plugin

Install Zinit

$ bash -c "$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"

Install Zinit plugin manager

Load plugin with Zinit

$ zinit light zsh-users/zsh-autosuggestions

Load a plugin using Zinit

Bypass alias

$ \ls

Run original command, bypass alias

Common useful aliases

$ alias ..='cd ..' ...='cd ../..' ll='ls -la' la='ls -A'

Define common navigation aliases

Create alias

$ alias ll='ls -la'

Create a new alias

Global alias

$ alias -g G='| grep'

Create global alias (works anywhere in command)

List all aliases

$ alias

Show all defined aliases

Remove alias

$ unalias ll

Remove an alias

Suffix alias

$ alias -s txt=code

Open .txt files with code by typing filename

Check alias definition

$ which ll

Show what an alias expands to

Initialize completions

$ autoload -Uz compinit && compinit

Initialize zsh completion system

Menu-style completion

$ zstyle ':completion:*' menu select

Enable menu-style tab completion

History substring search

$ bindkey '^[[A' history-substring-search-up

Search history with up arrow

Show available colors

$ for i in {0..255}; do print -Pn "%K{$i} %k%F{$i}${(l:3::0:)i}%f " ${${(M)$((i%6)):#3}:+$'\n'}; done

Display all 256 terminal colors

Basic prompt

$ PROMPT='%n@%m:%~%# '

Set basic prompt (user@host:dir)

Colored prompt

$ PROMPT='%F{green}%n%f@%F{blue}%m%f:%F{yellow}%~%f%# '

Set colored prompt

Prompt escape codes

$ # %n=user %m=host %~=dir %#=prompt %F{color}=fg %f=reset

Common prompt escape sequences reference

Enable git info in prompt

$ autoload -Uz vcs_info && precmd() { vcs_info }

Enable version control info in prompt

Right-side prompt

$ RPROMPT='%F{cyan}%*%f'

Set right-side prompt (shows time)

Transient prompt setup

$ # In p10k, set POWERLEVEL9K_TRANSIENT_PROMPT=same-dir

Simplify prompt after command execution

Discussion

Loading comments...