From eb62826522581c72921f82542e121d0e88f87acd Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 17 Aug 2026 09:12:38 +0000 Subject: [PATCH] docs: add plugin manager entrypoint injection notes Co-authored-by: mcornella <1441704+mcornella@users.noreply.github.com> --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index fb2993428..370770f15 100644 --- a/README.md +++ b/README.md @@ -450,6 +450,20 @@ Compatibility matrix: | `source $ZSH/oh-my-zsh.sh` | ✅ | ✅ | Full OMZ framework features | | `source $ZSH/lib/bootstrap.zsh` + manager-loaded OMZ plugins/themes | ✅ | ❌ | Plugin/theme prerequisites only | +#### Manager entrypoints and OMZ-side auto-injection limits + +Most plugin managers load OMZ by directly sourcing selected plugin/theme/lib entrypoints, not by sourcing +`oh-my-zsh.sh`, so OMZ cannot universally inject bootstrap on its own. + +| Manager | Typical OMZ entrypoint(s) it loads | Can OMZ auto-inject bootstrap without user hook? | +| :-- | :-- | :--: | +| Antigen | `antigen bundle ...` targets after `antigen use oh-my-zsh` | ❌ | +| Zinit | `OMZ::`, `OMZL::`, `OMZP::`, `OMZT::` snippets | ❌ | +| zgen | `zgen oh-my-zsh ...` selected OMZ paths | ❌ | +| zplug | `from:oh-my-zsh` selected OMZ entries | ❌ | +| antibody | `ohmyzsh/ohmyzsh path:...` selected OMZ paths | ❌ | +| zulu | OMZ package/module entries selected by zulu | ❌ | + ### Enable GNU ls In macOS And FreeBSD Systems