Skip to main content

Zsh Plugins

The Oh My Zsh plugin roster lives in one place — the plugins=(...) array in ~/.zshrc (source: dot_zshrc). Everything here is either bundled with OMZ or cloned automatically via chezmoi externals (.chezmoiexternal.toml), so a fresh machine gets the identical set from chezmoi apply.

The full roster

Every plugin has its own pro-tips page — the table links them all.

GroupPlugins
Git & forgesgit, git-auto-fetch, gh, shlink
Containers & clouddocker, docker-compose, aws, terraform, kubectl, kubectx, helm
Languages & packagesbrew, macos, python, pip, virtualenv, npm
Navigation & fileszoxide, eza, dirhistory, copypath, copyfile, extract
History & typingzsh-autosuggestions, history-substring-search, fzf, sudo, alias-finder, zsh-ai
Data & displayjsontools, urltools, zsh-syntax-highlighting, colored-man-pages, colorize

Load-order rules (encoded as comments in dot_zshrc — don't reorder casually):

  1. zsh-syntax-highlighting loads last of the "normal" plugins.
  2. history-substring-search is the one exception — its README requires it to load after syntax-highlighting, so it holds the final slot.

Deliberately not installed

PluginWhy not
zzoxide is already enabled and strictly better (frecency + zi interactive picker).
thefuckUnmaintained upstream; zsh-ai (# fix that + Enter) covers the use case.
zsh-autocompleteFights zsh-autosuggestions and the custom autosuggest-tab.zsh Tab binding.
fast-syntax-highlightingDrop-in for zsh-syntax-highlighting, but the zdharma repo-deletion history makes it a risky dependency for marginal gain.
1passwordSecrets come from OpenBao via Vault Agent, not 1Password.
web-searchzsh-ai answers from the terminal already.
command-not-foundOn macOS it needs the homebrew-command-not-found tap; this repo deliberately avoids tap-trust friction.

Each page keeps to the pro tips worth actually remembering — the aliases and keybinds that earn their muscle memory, aimed at how this setup is actually used (Compose-based StumpCloud ops, Gitea + GitHub, OpenBao secrets, the Docusaurus site, and a lot of Claude).