Skip to content

fix(skills): zi-install supports ZI_HOME overrides only with -i skip #639

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ss-o merged 1 commit into from
Sep 19, 2026
Merged

fix(skills): zi-install supports ZI_HOME overrides only with -i skip #639

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/skills/zi-install/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Prefer Loader for a new setup. Use `-i skip` when the user manages their dotfile
- `.zshrc` lives in `${ZDOTDIR:-$HOME}`; report that path before running. `ZDOTDIR` and `ZI_HOME`, when set, must be absolute: the installer changes directory before it reads them, so a relative value targets the wrong place. Stop and ask the user if either is relative.
- The installer honours `XDG_CONFIG_HOME` and `XDG_DATA_HOME` only when they are absolute; a relative value falls back to `~/.config` and `~/.local/share`. Say which directories will be used.
- An existing installation is detected by the installer (`~/.zi` or `$XDG_DATA_HOME/zi`, or an explicit `ZI_HOME`). Do not move or delete it.
- An explicit `ZI_HOME` or `ZI_BIN_DIR_NAME` is supported only with `-i skip`. The Loader block does not carry them, so with `-a loader` the first shell start would clone a second Zi at the default location (z-shell/src#217). If the user has either set and wants Loader, stop and explain that.
- `zsh`, `git`, and `curl` or `wget` must be present; the installer refuses without `git`.

## Run the installer
Expand Down
Loading