48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# zsh
|
|
|
|
GNU Stow package for my zsh setup. Stowed from the repo root with the
|
|
`.stowrc` defaults (`--dotfiles --target=$HOME`), i.e.:
|
|
|
|
```sh
|
|
stow zsh # stow (idempotent, safe to re-run)
|
|
stow -R zsh # re-stow after adding/removing files in this package
|
|
stow -D zsh # unstow
|
|
```
|
|
|
|
## Layout
|
|
|
|
| In this repo | Becomes (symlink) |
|
|
|-------------------------|-----------------------|
|
|
| `dot-zshrc` | `~/.zshrc` |
|
|
| `.zsh/alias.zsh` | `~/.zsh/alias.zsh` |
|
|
|
|
Other dirs under `~/.zsh/` (e.g. `local/`, `completions/`) are **not**
|
|
managed by stow — they are plain host-side directories and never touch
|
|
this repo.
|
|
|
|
## Host-local config: `~/.zsh/local`
|
|
|
|
`~/.zshrc` sources every `*.zsh` file in `~/.zsh/local/` at the **end**
|
|
of the file, in alphabetical order — so anything there can override
|
|
aliases, PATH, env vars, etc. set earlier.
|
|
|
|
This is the place for **host-specific, non-shared** config: business/work
|
|
inits, private env vars, machine-specific paths, per-host aliases and
|
|
functions.
|
|
|
|
The directory is **not** in the repo — it exists only on each host, so
|
|
after cloning + stowing on a new machine, create it once:
|
|
|
|
```sh
|
|
mkdir -p ~/.zsh/local
|
|
```
|
|
|
|
(The sourcing loop in `.zshrc` tolerates the directory being missing.)
|
|
|
|
## Notes
|
|
|
|
- Editing existing files (`.zshrc`, `alias.zsh`) needs no restow — they're
|
|
symlinks. Only new/deleted files in this package require `stow -R zsh`.
|
|
- zinit, Powerlevel10k and the plugins auto-clone on first shell start;
|
|
first launch may take a minute.
|