TimJ
Posted on • Updated on
#productivity #linux #bash #wsl
This guide will look at various ways you can improve your productivity by extending the functionality of your terminal, including:
- zsh: A powerful shell that extends the feature set of bash.
- zsh plugins: Auto-suggestions, completion, syntax highlighting and more.
- prompts + themes: Customize a clean prompt that displays contextual information, either using Powerlevel10k or Posh.
We'll go from this:
To this:
Getting Started
- Install oh-my-zsh for any Unix based shell or WSL2, which bundles
zshwith a set of plugins and themes. - Download a Nerd Font and set your favourite terminal to use it. I like
Cascaydia Cove Nerd Fontthe best.
Zsh Plugins
To enable plugins locate your .zshrc in your $HOME directory, and add to the list of plugins:
plugins=( git ...)
Plugins Included with oh-my-zsh
sudo: Easily prefix your current or previous commands withsudoby pressing esc twice.dotenv: Automatically load your projectENVvariables from.envfile when you cd into project root directory. By default, it will prompt before loading, but you can turn this off by adding the following to your.zshrc(though be wary of the security implications of this):
export ZSH_DOTENV_PROMPT=falsecopypath: Copies the path of given directory or file to the system clipboard.copyfile: Puts the contents of a file in your system clipboard so you can paste it anywhere.copybuffer: This plugin binds the ctrl-o keyboard shortcut to a command that copies the text that is currently typed in the command line ($BUFFER) to the system clipboard.command-not-found: provide suggested packages to be installed if a command cannot be found.web-search: This plugin adds aliases for searching with Google, Wiki, Bing, YouTube and other popular services.history: Provides a couple of convenient aliases for using the history command to examine your command line history.dirhistory: Adds keyboard shortcuts for navigating directory history and hierarchy. Uses alt-arrowkeys by default, so ensure these do not conflict with other shortcuts.colorize: Syntax-highlight file contents of over 300 supported languages and other text formats.colored-man-pages: Adds colors to man pages.magic-enter: This plugin makes your enter key magical, by binding commonly used commands to it. You customize the command it uses, and run specific commands in a Git repo:
MAGIC_ENTER_GIT_COMMAND='git status -sb .'MAGIC_ENTER_OTHER_COMMAND='ls -la .'
jsontools: Handy command line tools for dealing with json data.
Depending on what other software you use, there are plenty of lightweight plugins that improve autocompletion and provide aliases among other things. I use:
git: Aliases for Gitgh: Completions for GitHub cligit-auto-fetch: Periodically rungit fetchnvm: Completions for nvmnpm: Completions + aliases for npmaws: Completions for awsdocker: Completions for dockerdocker-compose: Completions + aliases for docker composekubectl" Completions + aliases for kubectlvscode: Aliases for VS Code or VSCodium editorpython: Aliases for pythonpip: Automcompletions for piptmux: Aliases for tmux
Powerful Plugins
These plugins do not come with oh-my-zsh, so you must clone the repos and place them in ~/ohmyzsh/custom/plugins/ before adding them to the plugins list in the .zshrc.
zsh-autosuggestions:Suggests commands as you type based on history and completions, which can then be selected with →.
- Autosuggestions can either use your
history, or tabcompletion. Set this with theZSH_AUTOSUGGEST_STRATEGYvariable. - Has some compatability issues where the suggestion is not cleared after certain actions. To fix this, add the following to your
.zshrc:
- Autosuggestions can either use your
ZSH_AUTOSUGGEST_CLEAR_WIDGETS+=(bracketed-paste up-line-or-search down-line-or-search expand-or-complete accept-line push-line-or-edit)
zsh-syntax-highlighting: Syntax highlighting for the shell zsh.zsh-autocomplete: Provides completion suggestions below the prompt, in addition to a history menu. This one is powerful, but might take some getting used to. Like with autosuggestions, you can choose whether you want to use normal completions (directories, man, etc.) or history search. I like to have autocomplete for normal completions and autosuggestions for history. If you're like me and don't like the history menu, but want all the other features, you can change the keybinds to use a simple history search in your .zshrc(make sure this is after the plugins have been loaded):
If you're like me and don't like the history menu, but want all the other features, you can change the keybinds to use a simple history search in your bindkey '\e[A' history-beginning-search-backwardbindkey '\eOA' history-beginning-search-backwardbindkey '\e[B' history-beginning-search-forwardbindkey '\eOB' history-beginning-search-forwardzle -A {.,}history-incremental-search-forwardzle -A {.,}history-incremental-search-backward
Similarly, to use the default tab completion, set the following options:
zstyle ':autocomplete:*' widget-style menu-selectbindkey -M menuselect '\r' accept-line
I also don't like the completions to move the prompt around too much, especially for a multiline prompt. We can change this with:
zstyle ':autocomplete:*' list-lines 7
The plugin also has some issues with the prompt "" showing on some completions and eating inputs. Add this to your .zshrc as a workaround (however this sometimes drops completions entirely, but I still prefer this over loosing inputs):
zstyle ':completion:*' menu select=longFor a full list of config options, go here.
zsh-z: Tool to jump quickly to directories that you have visited frequently.zsh-direnv: Alternative todotenv, which also provides the use of a.envrcwith utility functions.
To take things further, I recommend checking out this curated list of plugins.
Themes + Custom Prompts
We can improve our prompt to contain additional information, such as execution time, performance metrics, and even things like your current Git branch. Set your theme by adding the following to your .zshrc (set to random until you find something you like):
ZSH_THEME="mytheme"
I like agnoster best:
As nice as our prompt looks, we can take things further.
We have 2 options:
Option A: Powerlevel10k
Powerlevel10k is a highly customizable theme for zsh. It includes some nice features such as an instant prompt while plugins are loading, and a configuration wizard to get you started.
This is what my prompt looks like:
I've modified the configuration a bit to use custom icons for specific directories and cleaned up the git status a bit. See my .p10k.zsh
Option B: oh-my-posh
oh-my-posh:
provides a wide range of themes to choose from, though is missing some features of Powerlevel10k such as instant prompt.
- Follow installation instructions and find a theme you like. Some favourites of mine are
clean-detailed,blueish, ornu4a. - Add the path to your chosen theme to
.zshrc:
eval "$(oh-my-posh --init --shell zsh --config ~/.mytheme.omp.json)"
Other Customization for .zshrc
For reference, see my complete .zshrc
- Disable auto zsh updates:
zstyle ':omz:update' mode disabled - Print
...while waiting for completions to load (doesn't work with zsh-autocomplete):COMPLETION_WAITING_DOTS="true" - Custom aliases. For oh-my-zsh, it is recommended to put aliases in a different file:
~/.oh-my-zsh/custom/aliases.zsh. Some I like to use for networking things:
alias get-ports="netstat -tulnp | grep LISTEN"alias get-router="ip route | grep default"alias get-ip="hostname -I"
You can also create an alias function with parameters. For example, to backup a file:
bak() { cp $1{,.bak}}
We can check that a command exists before setting the alias. For example, we can check docker is installed:
if [ -x "$(command -v docker)" ]; then alias dw="watch \"docker ps --format \\\"table {{.Names}}\t{{.Status}}\\\" -a\""fi
See all my aliases in my aliases.zsh. Note that for git aliases, it is best to define them in your .gitconfig.
- Custom keybinds. For example:
bindkey '^H' backward-kill-wordbinds ctrl-bksp to delete by word. Find keycodes here.Those familiar with vim shortcuts can addbindkey -vto their.zshrc. Be wary of conflicts with other keybinds/plugins! - Change the default colors for certain directories by adding the following to my
.zshrc(go here for color codes):
zstyle ':completion:*:default' list-colors \ "ow=30;43"
Alternatively, you can export a complete color scheme from file:
eval "$(dircolors ~/.dircolors)";
- Set preferred editor for specific files:
alias -s {cs,ts,html,json,xml,md}=code
- Set preferred editior for
ssh, for example:
if [[ -n $SSH_CONNECTION ]]; then export EDITOR='vim'else export EDITOR='code'fi
- Organize all your environment variables in another file:
export $(cat ~/.my_env) - You can automatically install packages, for example you can install nvm:
export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
Next Steps
- Install tmux for tabs, panes and more natively in the shell. See oh-my-tmux and my
tmux.conf.local. - Install a better terminal. My suggestions:
- Ubuntu: Guake
- Windows: Windows Terminal
- MacOS: iTerm2
- Read this blog for some general CLI utilies to boost your productivity further.
