Frank Qing
9257eceb47
The pyenv fragment lived in the interactive overlay, so agents and zsh -c fell back to system Python. Install it through the always-on fragment path and keep XDG destinations aligned with the loader.
62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
curl -fsSL https://git.miomio.moe/mio/easyzsh/raw/branch/master/install.sh | bash
|
|
```
|
|
|
|
Options:
|
|
|
|
- `--cp-hist` / `-c` — import bash history
|
|
- `--non-interactive` / `-n` — skip default-shell change and optional prompts
|
|
- `--with <names>` — install optional add-ons (comma-separated, repeatable).
|
|
Each name runs `install_<name>.sh` (currently: `fnm`, `pyenv`, `nvm`).
|
|
Interactive installs (without `-n` and without `--with`) prompt for the same list.
|
|
|
|
```bash
|
|
./install.sh --with fnm
|
|
./install.sh --with fnm,pyenv -n
|
|
curl -fsSL …/install.sh | bash -s -- --with fnm
|
|
```
|
|
|
|
From a git checkout (shell stubs only):
|
|
|
|
```bash
|
|
./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.
|
|
|
|
```bash
|
|
# ~/.config/zsh/local.zsh
|
|
. "$HOME/.cargo/env"
|
|
|
|
# ~/.config/zshrc/prefs.zsh
|
|
plugins+=(docker)
|
|
```
|
|
|
|
Tool fragments from this repo:
|
|
|
|
```bash
|
|
# always-on (sourced from ~/.zshenv)
|
|
curl -fsSL https://git.miomio.moe/mio/easyzsh/raw/branch/master/patch.sh | bash -s -- zsh/fnm zsh/pyenv
|
|
```
|