登录

antidote

mattmc3MIT活跃维护

用纯 Shell 实现的 zsh 插件管理器，通过并行加载和静态缓存解决 zsh 启动慢、插件管理卡顿的问题。

https://antidote.sh - the cure to slow zsh plugin management

v2.3.0发布于 2026-08-07 17:29 UTC1,825star39fork同步于 2026-11-07 07:32 UTC
zsh 插件管理Shell 脚本启动加速并行加载dotfiles
对比 GitHub 官网antidotedotfilesshellzshzsh-plugin

怎么上手

由 README 提炼，执行前请确认
原文 
git clone --depth=1 https://github.com/mattmc3/antidote.git ${ZDOTDIR:-$HOME}/.antidote
source /path-to-antidote/antidote.zsh
antidote load ${ZDOTDIR:-$HOME}/.zsh_plugins.txt
硬件要求按 README 说明

README 未说明，仅需可运行 Zsh 的环境，无 GPU 或显存要求

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

Zsh 插件管理器，兼容 antibody/antigen 写法，解决插件加载慢的问题

用纯 Shell 实现的 zsh 插件管理器，通过并行加载和静态缓存解决 zsh 启动慢、插件管理卡顿的问题。

核心能力

  • 沿用 antibody/antigen 的 .zsh_plugins.txt 插件清单写法
  • 用静态插件文件实现极快的插件加载
  • 支持 kind:defer 延迟加载兼容的插件
  • 可直接引用 Oh My Zsh 的 lib 与 plugins 路径
  • 附带 bat 的 .zsh_plugins.txt 语法高亮定义

容易踩的坑

需在交互式 zsh 会话中执行安装命令；延迟加载仅对声明支持 zsh-defer 的插件有效；静态加载文件需在 .zsh_plugins.txt 更新后重新生成

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v2.3.0
全部 release
  1. v2.3.0最新正式版2026-08-07 · 2026-08-07 17:29 UTC

    [v2.3.0]

    • Add a preset: directive setting fallback annotations for every later entry of a bundle, so pin: and the like need not repeat on each line. Keyed by clone directory, so the short, https, and ssh spellings share one set. Line-level and using: values win.
    • Speed up dynamic mode by resolving antidote init in the parent shell instead of a subprocess, and dropping four forks from every antidote invocation. A warm source <(antidote init) startup goes from roughly 50ms to 35ms, and antidote init itself from 13.5ms to 1ms.
    • Read the config file once per shell instead of once per command. antidote-setup sources it into the parent shell so parent-side code sees its zstyles; anything set before antidote loads still wins.
    • Make a lone antidote.zsh usable when sourced, falling back to a shim that routes commands to the subprocess. antidote load and dynamic mode still need the full install.
    • Fix a config file's zstyle ':antidote:home' dir ... being invisible to parent-shell code. antidote home reported the default path and the rebundle checkfile landed there, so antidote update never cleared it and the forced rebundle after an update stopped happening.
    • Fix a static .zwc built by a different Zsh version never being rebuilt, leaving every shell on that version silently parsing the source.
    • Fix kind:autoload functions never loading under ksh_arrays. The generated script indexed $fpath[1], which is not a subscript under that option, so autoload got no arguments.
    • Fix nested dispatch (load calling bundle) dropping the user's KSH_ARRAYS and SH_GLOB.
    • Fix ANTIDOTE_CONFIG not crossing the process boundary, and an exported ANTIDOTE_TMPDIR being clobbered by TMPDIR.
    • Fix antidote update and bundle zcompilation failing when ANTIDOTE_HOME contains spaces.
    • Fix antidote install writing :value garbage to the plugins file for unknown long flags. It now errors.
    • Fix a preset: not carrying across dynamic-mode antidote bundle calls.
    • Fix bundles that failed to parse still being cloned, and parse errors on a path-style using: line being lost with the dropped entry.
    • Add misc/grammar.md documenting the plugins file format: tokenization, directives, annotations, bundle type resolution, and errors. Document using: and preset: in the antidote-bundle man page and the syntax highlighter.
    • Internal: discover parser contexts by name instead of listing each by hand in four places, where a missed edit failed silently.

    Full Changelog: https://github.com/mattmc3/antidote/compare/v2.2.2...v2.3.0

  2. v2.2.22026-08-04 · 2026-08-04 21:41 UTC
    查看更新说明

    [v2.2.2]

    • Fix git's own output during a clone leaking into the generated static file, where a line like warning: redirecting to https://... becomes a command at shell startup.
    • Fix pre: and post: hooks not running for kind:clone bundles. Clone-only bundles still emit no load script unless a hook is present.
    • Fix dynamic-mode heredoc bundles leaking __adote_script='' to stdout at shell startup.
    • Fix concurrent antidote load shells racing while rebuilding the same static file. Rebuilds now use per-process temp files, fall back to the last known-good static file on failure, and clean up stale temp files from interrupted builds.
    • Improve color detection by asking terminfo for terminal color support, honoring FORCE_COLOR, and treating CLICOLOR=0 as an opt-out.
    • Speed up internal helpers by replacing fork-heavy paths with Zsh builtins for bundle discovery, JSON escaping, and command checks.
    • Add test fixtures for submodules and non-main default branches, covering clone/update paths that were previously untested.
    • Update the architecture guide with cloning and update sequence diagrams and refreshed implementation notes.

    Full Changelog: https://github.com/mattmc3/antidote/compare/v2.2.1...v2.2.2

  3. v2.2.12026-07-28 · 2026-07-28 14:08 UTC
    查看更新说明

    [v2.2.1]

    • Fix a cold dynamic-mode startup stalling on bundles with a big history.
    • Fix antidote update intermittently failing with fatal: Cannot rebase onto multiple branches right after a fresh clone (#273). Git appends to FETCH_HEAD without locking it, so the background deepen started by a clone could corrupt what git pull read on the same repo. Update now rebases onto the remote-tracking ref instead of FETCH_HEAD.
    • Fix antidote update failing on a bundle whose shallow clone is grafted so git cannot see its commit as an ancestor of upstream. The rebase replayed commits that were already upstream and conflicted; update now takes upstream as-is for that case, keeping local changes that no longer apply in the stash rather than writing conflict markers into a plugin file.
    • Fix antidote update printing no commit list under the updated: line whenever the old commit had no parent in the clone, which is any shallow bundle and any repo updated from its root commit. The list also no longer repeats the commit you were already on.
    • Fix antidote commands failing with function definition file not found after a package manager upgrade (#271). Setup resolved its own install path through symlinks, so a Homebrew shell recorded the versioned keg directory instead of the stable share/antidote link. Upgrading deleted that keg out from under every running shell, breaking any function not yet autoloaded.
  4. v2.2.02026-07-27 · 2026-07-27 03:30 UTC
    查看更新说明

    [v2.2.0]

    • Add zstyle ':antidote:bundle:*' min-age <days> to keep bundles a fixed number of days behind upstream, giving a bad push time to be noticed before it reaches your shell. Clones and updates stop at the newest commit that has been upstream long enough. A plugin with no commit that old is still installed at its latest commit. Pinned bundles ignore it. Commit dates are attacker-controlled, so treat this as a cushion, not a supply chain guarantee, and use pin: when you need a fixed commit.
    • Clone bundles shallow, then deepen them with a background fetch, so the first run stays fast but full history is available afterward. Set zstyle ':antidote:bundle:*' shallow 'yes' to hold a bundle at its shallow clone.
    • Make dynamic bundling dramatically faster by caching each antidote bundle line's generated script under $ANTIDOTE_HOME/.dynamic, so source <(antidote init) shells reuse the cached script instead of forking a subprocess per line. On local fixtures that takes a warm bundle line from roughly 30ms to under 0.5ms! Set zstyle ':antidote:dynamic' zcompile 'yes' to also compile the cached scripts.
    • Fix a theme repo sourcing every .zsh-theme it ships when none is named for the repo directory. Bundling romkatv/powerlevel10k sourced both powerlevel10k.zsh-theme and the powerlevel9k compatibility shim.
    • Fix antidote update reporting success when a worker failed, and fix bundles with the same short name overwriting each other's reports.
    • Fix antidote update --dry-run deepening shallow clones, a permanent side effect from a dry run, and repair the temp dir cleanup trap.
    • Fix antidote update treating a shallow.lock held by a background deepen as an update failure rather than contention.
    • Fix antidote load discarding the existing static file when regeneration failed.

    Full Changelog: https://github.com/mattmc3/antidote/compare/v2.1.1...v2.2.0

  5. v2.1.12026-07-26 · 2026-07-26 15:52 UTC
    查看更新说明

    [v2.1.1]

    • Fix antidote.zsh exiting the shell when sourced from compiled .zwc bytecode (#270). Zsh reports the eval context as filecode rather than file in that case, so the sourced check fell through to the CLI branch.
    • Fix antidote bundle exiting 1 for bundle files containing only kind:clone entries, and make it exit non-zero when a clone or a parallel script generation job fails. Previously those failures printed to stderr but still exited 0.
    • Fix antidote load returning 0 when the static file was missing or could not be sourced.
    • Fix antidote update printing "self-update complete" after a failed self-update. It now reports the error and returns 1.
    • Fix antidote purge commenting out unrelated bundles in the plugins file when one bundle name was a prefix of another (eg: purging foo/bar also matched foo/barbaz). Names now match literally, whole word only.
    • Fix antidote install silently writing :value garbage to the plugins file for unknown short flags. It now fails with an error.
    • Fix antidote snapshot restore reporting success when restores failed, and fix pinned restores always failing under ephemeral pins.
    • Fix antidote list --jsonl producing invalid JSON when values contained quotes, backslashes, or control characters.
    • Fix antidote-dispatch and antidote-help leaking private usage helper functions into the user's shell.
    • Fix the non-Zsh guard misreporting the shell name, and tolerate a ps without -p (busybox).
    • Speed up antidote update by only probing for bat when the snapshot picker actually runs.
    • Ehance completions: install gains arg specs, a --pin value, and bundle positionals; path completes installed bundles; help completes topics; load and snapshot complete files.
    • Remove unused git config isolation from update that would have broken credential helpers and insteadOf rewrites had it ever taken effect.
    • Add an ARCHITECTURE.md guide covering file layout, the parent/subprocess boundary, and the bundle pipeline.
    • Internal: rename globals so ANTIDOTE_* means externally managed only, decompose oversized functions, and make antidote.zsh clean under warn_nested_var. No behavior changes.
    • Internal: migrate the test suite from clitest markdown files to bats (tests/bats), with network tests split out under just test-real.

    Full Changelog: https://github.com/mattmc3/antidote/compare/v2.1.0...v2.1.1

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    antidote

    MIT License version

    Get the cure

    Meet antidote, a feature-complete Zsh implementation of the legacy Antibody plugin manager, which in turn was derived from Antigen. It not only aims to provide continuity for those legacy plugin managers, but also to delight new users with high-performance, easy-to-use Zsh plugin management.

    Usage

    Basic usage should look really familiar to you if you have used antibody or antigen. Bundles (aka: Zsh plugins) are stored in a file typically called .zsh_plugins.txt.

    # .zsh_plugins.txt
rupa/z              # some bash plugins work too
sindresorhus/pure   # enhance your prompt

# you can even use Oh My Zsh plugins
getantidote/use-omz
ohmyzsh/ohmyzsh path:lib
ohmyzsh/ohmyzsh path:plugins/extract

# add fish-like features
zsh-users/zsh-syntax-highlighting
zsh-users/zsh-autosuggestions
zsh-users/zsh-history-substring-search

    A typical .zshrc might then look like:

    # .zshrc
source /path-to-antidote/antidote.zsh
antidote load ${ZDOTDIR:-$HOME}/.zsh_plugins.txt

    The full documentation can be found at https://antidote.sh.

    Help getting started

    If you want to see a full-featured example Zsh configuration using antidote, you can have a look at this example zdotdir project. Feel free to incorporate code or plugins from it into your own dotfiles, or you can fork it to get started building your own Zsh config from scratch driven by antidote.

    Installation

    Install with git

    You can install the latest release of antidote by cloning it with git:

    # first, run this from an interactive zsh terminal session:
git clone --depth=1 https://github.com/mattmc3/antidote.git ${ZDOTDIR:-$HOME}/.antidote

    Install with a package manager

    antidote may also be available in your system's package manager:

    Performance

    antidote supports ultra-high performance plugin loads using a static plugin file. It also allows deferred loading for plugins that support it.

    # .zsh_plugins.txt
# some plugins support deferred loading
zdharma-continuum/fast-syntax-highlighting kind:defer
zsh-users/zsh-autosuggestions kind:defer
zsh-users/zsh-history-substring-search kind:defer

    # .zshrc
# Lazy-load antidote and generate the static load file only when needed
zsh_plugins=${ZDOTDIR:-$HOME}/.zsh_plugins
if [[ ! ${zsh_plugins}.zsh -nt ${zsh_plugins}.txt ]]; then
  (
    source /path-to-antidote/antidote.zsh
    antidote bundle <${zsh_plugins}.txt >${zsh_plugins}.zsh
  )
fi
source ${zsh_plugins}.zsh

    bat syntax highlighting

    If you use bat, antidote includes a syntax definition for .zsh_plugins.txt files. To install it:

    bat_syntax_dir="$(bat --config-dir)/syntaxes"
mkdir -p "$bat_syntax_dir"
curl -fsSL https://raw.githubusercontent.com/mattmc3/antidote/main/misc/zsh_plugins.sublime-syntax \
  -o "$bat_syntax_dir/zsh_plugins.sublime-syntax"
bat cache --build

    Benchmarks

    You can see how antidote compares with other setups here.

    Plugin authors

    If you authored a Zsh plugin, the recommended snippet for antidote is:

    antidote install gh_user/gh_repo

    If your plugin is hosted somewhere other than GitHub, you can use this:

    antidote install https://bitbucket.org/bb_user/bb_repo

    Credits

    A big thank you to Carlos for all his work on antibody over the years.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    ohmyzsh
    ohmyzsh·Shell

    一套社区维护的 zsh 配置管理框架，内置 300+ 插件和 140+ 主题，帮你快速搭好顺手的终端环境并自动更新。

    zsh 配置+4桌面美化 / 主题
    190428+9227k2026-11-09 12:36 UTC
    warp
    warpdotdev·Rust

    基于 Rust 打造的智能体开发环境，从终端演化而来，把 AI 代理能力直接融入命令行，让写代码、跑命令和调试更顺手。

    终端模拟器+4桌面美化 / 主题
    65960+595.8kv0.2026.06.09.19.54.dev_002026-11-10 17:13 UTC
    NvChad
    NvChad·Lua

    基于 Lua 的 Neovim 配置框架，开箱即用，自带合理默认设置和漂亮界面，省去从零折腾配置的麻烦。

    Neovim 配置+3桌面美化 / 主题
    28541+92.2kv2.52026-10-24 22:01 UTC
    .tmux
    gpakosz·Shell

    一套开箱即用的 tmux 配置，自带主题、状态栏和常用快捷键，省去自己写 .tmux.conf 的麻烦，让终端多窗口操作更顺手。

    tmux 配置+4桌面美化 / 主题
    25471+33.6k2026-10-21 15:47 UTC