configuring-zsh
1
总安装量
1
周安装量
#46918
全站排名
安装命令
npx skills add https://github.com/mrpointer/dotfiles --skill configuring-zsh
Agent 安装分布
amp
1
opencode
1
cursor
1
kimi-cli
1
github-copilot
1
Skill 文档
Zsh Shell Configuration
Quick Reference
| Topic | Reference |
|---|---|
| Startup file order | startup-files.md |
| oh-my-zsh patterns | oh-my-zsh.md |
| powerlevel10k setup | powerlevel10k.md |
| sheldon plugin manager | sheldon.md |
| Plugin load order | plugins.md |
| Performance tuning | performance.md |
Workflow Decision Tree
| Need to… | Action |
|---|---|
| Set env vars / PATH / locales | Read startup-files.md â edit .zshenv or .zprofile |
| Configure aliases, keybinds, completions, prompt | Edit .zshrc |
| Fix performance issues | Read performance.md â profile startup |
| Add/configure plugins | Read plugins.md + relevant manager reference |
Chezmoi Integration
- Edit Zsh configs in the chezmoi source (this repo), not directly in
~ - Respect
{{ ... }}template blocks in files - Source naming:
dot_zshrcâ~/.zshrc,private_dot_config/sheldonâ~/.config/sheldon - For chezmoi workflows, see
managing-chezmoiskill
Default Guardrails
- Keep
.zshenvidempotent and fast; no external commands - No aliases/functions in
.zshenv - Use
typeset -gx VAR=...orexport VAR=...with defensive checks - Set
fpathbeforecompinit; runcompinitonce only - Document plugin load order (especially
zsh-autocomplete+zsh-syntax-highlighting)
Common Tasks
| Task | Approach |
|---|---|
| Add env var | .zshenv (everywhere) vs .zprofile (login) vs .zshrc (interactive) |
| Fix PATH | Ensure ordering, remove duplicates, avoid PATH=$PATH:... in multiple files |
| Enable completions | Set fpath â compinit once â cache if needed |
| Add plugin | Choose manager â ensure correct load order |
| Setup p10k | Instant prompt block first in .zshrc â source ~/.p10k.zsh after plugins |