Files
easyzsh/README.md
T
Jeffrey 42c8305871 fix(fnm): load managed Node from always-on zsh layer
fnm lived in interactive-only ~/.config/zshrc, so ssh/agents/zsh -c
missed fnm-managed node. Source ~/.config/zsh/*.zsh from .zshenv and
install the fragment as zsh/fnm instead.
2026-08-07 14:08:07 +08:00

1.7 KiB

Easy Zsh Setup

One-command zsh environment: oh-my-zsh, powerlevel10k, and a curated plugin set (autosuggestions, syntax-highlighting, completions, history-substring-search, fzf-tab, k), plus eza, zoxide, fzf, and Nerd Fonts.

Install

curl -fsSL https://git.miomio.moe/mio/easyzsh/raw/branch/master/install.sh | bash

Options: --cp-hist / -c imports bash history; --non-interactive / -n skips the default-shell change.

From a git checkout:

./deploy.sh

Layout

Path Role Reinstall
~/.zshenv Always-on: Homebrew, ~/.local/bin, ~/.config/zsh/*.zsh, then local.zsh Overwritten
~/.zshrc Interactive: omz, plugins, aliases, fzf, zoxide Overwritten
~/.config/zsh/*.zsh Always-on tool fragments (e.g. fnm.zsh) Left alone (via patch.sh)
~/.config/zsh/local.zsh Machine-local overrides (every zsh, including agents) Never overwritten
~/.config/zshrc/*.zsh Personal/tool overlays before oh-my-zsh (interactive) Left alone
~/.local/bin/ User tools + shims (e.g. grok~/.grok/bin/grok) Left alone

easyzsh does not manage ~/.zprofile. Put machine/login hooks in local.zsh.

Do not put ~/.grok/bin on PATH wholesale.

# ~/.config/zsh/local.zsh
. "$HOME/.cargo/env"

# ~/.config/zshrc/prefs.zsh
plugins+=(docker)

Tool fragments from this repo:

# always-on (sourced from ~/.zshenv)
curl -fsSL https://git.miomio.moe/mio/easyzsh/raw/branch/master/patch.sh | bash -s -- zsh/fnm

# interactive-only (sourced from ~/.zshrc)
curl -fsSL https://git.miomio.moe/mio/easyzsh/raw/branch/master/patch.sh | bash -s -- pyenv