{"id":13753869,"url":"https://github.com/mattmc3/antidote","last_synced_at":"2026-04-02T18:46:59.139Z","repository":{"id":43092631,"uuid":"324684312","full_name":"mattmc3/antidote","owner":"mattmc3","description":"https://antidote.sh - the cure to slow zsh plugin management","archived":false,"fork":false,"pushed_at":"2025-05-13T16:29:32.000Z","size":805,"stargazers_count":1110,"open_issues_count":11,"forks_count":30,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-05-13T16:46:31.744Z","etag":null,"topics":["antidote","dotfiles","shell","zsh","zsh-plugin","zsh-plugin-manager"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattmc3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-12-27T04:12:49.000Z","updated_at":"2025-05-13T15:37:02.000Z","dependencies_parsed_at":"2023-09-27T00:21:18.531Z","dependency_job_id":"9dbc247d-3026-4ede-921c-b3e0febcc218","html_url":"https://github.com/mattmc3/antidote","commit_stats":{"total_commits":438,"total_committers":10,"mean_commits":43.8,"dds":"0.020547945205479423","last_synced_commit":"4858ab37c1cef407bf4bc3b398b28fb71c5ee954"},"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmc3%2Fantidote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmc3%2Fantidote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmc3%2Fantidote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmc3%2Fantidote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattmc3","download_url":"https://codeload.github.com/mattmc3/antidote/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235696,"owners_count":22036963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["antidote","dotfiles","shell","zsh","zsh-plugin","zsh-plugin-manager"],"created_at":"2024-08-03T09:01:32.113Z","updated_at":"2026-04-02T18:46:59.127Z","avatar_url":"https://github.com/mattmc3.png","language":"Shell","funding_links":[],"categories":["shell","Shell"],"sub_categories":[],"readme":"# antidote\n\n[![MIT License](https://img.shields.io/badge/license-MIT-007EC7.svg)](/LICENSE)\n![version](https://img.shields.io/badge/version-v2.0.12-df5e88)\n\n\u003ca title=\"GetAntidote\"\n   href=\"https://antidote.sh\"\n   align=\"right\"\u003e\n\u003cimg align=\"right\"\n     height=\"80\"\n     alt=\"GetAntidote Logo\"\n     src=\"https://avatars.githubusercontent.com/u/101279220?s=80\u0026v=4\"\u003e\n\u003c/a\u003e\n\n\u003e [Get the cure][antidote]\u003c/blockquote\u003e\n\n[Antidote][antidote] is a feature-complete Zsh implementation of the legacy\n[Antibody][antibody] plugin manager, which in turn was derived from [Antigen][antigen].\nAntidote not only aims to provide continuity for those legacy plugin managers, but also\nto delight new users with high-performance, easy-to-use Zsh plugin management.\n\n## Usage\n\nBasic usage should look really familiar to you if you have used Antibody or Antigen.\nBundles (aka: Zsh plugins) are stored in a file typically called `.zsh_plugins.txt`.\n\n```zsh\n# .zsh_plugins.txt\nrupa/z              # some bash plugins work too\nsindresorhus/pure   # enhance your prompt\n\n# you can even use Oh My Zsh plugins\ngetantidote/use-omz\nohmyzsh/ohmyzsh path:lib\nohmyzsh/ohmyzsh path:plugins/extract\n\n# add fish-like features\nzsh-users/zsh-syntax-highlighting\nzsh-users/zsh-autosuggestions\nzsh-users/zsh-history-substring-search\n```\n\nA typical `.zshrc` might then look like:\n\n```zsh\n# .zshrc\nsource /path-to-antidote/antidote.zsh\nantidote load ${ZDOTDIR:-$HOME}/.zsh_plugins.txt\n```\n\nThe full documentation can be found at [https://antidote.sh][antidote].\n\n## Help getting started\n\nIf you want to see a full-featured example Zsh configuration using antidote, you can\nhave a look at this [example zdotdir](https://github.com/getantidote/zdotdir) project.\nFeel free to incorporate code or plugins from it into your own dotfiles, or you can fork\nit to get started building your own Zsh config from scratch driven by antidote.\n\n## Installation\n\n### Install with git\n\nYou can install the latest release of antidote by cloning it with `git`:\n\n```zsh\n# first, run this from an interactive zsh terminal session:\ngit clone --depth=1 https://github.com/mattmc3/antidote.git ${ZDOTDIR:-$HOME}/.antidote\n```\n\n### Install with a package manager\n\nantidote may also be available in your system's package manager:\n\n- [macOS homebrew](https://formulae.brew.sh/formula/antidote): `brew install antidote`\n- [Arch AUR](https://aur.archlinux.org/packages/zsh-antidote): `yay -S zsh-antidote`\n- [Nix Home-Manager](https://mipmip.github.io/home-manager-option-search/?query=antidote) : `programs.zsh.antidote.enable = true;`\n\n## Performance\n\nantidote supports ultra-high performance plugin loads using a static plugin file.\nIt also allows deferred loading for [plugins that support it](https://github.com/romkatv/zsh-defer#caveats).\n\n```zsh\n# .zsh_plugins.txt\n# some plugins support deferred loading\nzdharma-continuum/fast-syntax-highlighting kind:defer\nzsh-users/zsh-autosuggestions kind:defer\nzsh-users/zsh-history-substring-search kind:defer\n```\n\n```zsh\n# .zshrc\n# Lazy-load antidote and generate the static load file only when needed\nzsh_plugins=${ZDOTDIR:-$HOME}/.zsh_plugins\nif [[ ! ${zsh_plugins}.zsh -nt ${zsh_plugins}.txt ]]; then\n  (\n    source /path-to-antidote/antidote.zsh\n    antidote bundle \u003c${zsh_plugins}.txt \u003e${zsh_plugins}.zsh\n  )\nfi\nsource ${zsh_plugins}.zsh\n```\n\n## bat syntax highlighting\n\nIf you use [bat](https://github.com/sharkdp/bat), antidote includes a syntax definition\nfor `.zsh_plugins.txt` files. To install it:\n\n```zsh\nbat_syntax_dir=\"$(bat --config-dir)/syntaxes\"\nmkdir -p \"$bat_syntax_dir\"\ncurl -fsSL https://raw.githubusercontent.com/mattmc3/antidote/main/misc/zsh_plugins.sublime-syntax \\\n  -o \"$bat_syntax_dir/zsh_plugins.sublime-syntax\"\nbat cache --build\n```\n\n## Benchmarks\n\nYou can see how antidote compares with other setups [here][benchmarks].\n\n## Plugin authors\n\nIf you authored a Zsh plugin, the recommended snippet for antidote is:\n\n```zsh\nantidote install gh_user/gh_repo\n```\n\nIf your plugin is hosted somewhere other than GitHub, you can use this:\n\n```zsh\nantidote install https://bitbucket.org/bb_user/bb_repo\n```\n\n## Credits\n\nA big thank you to [Carlos](https://github.com/caarlos0) for all his work on\n[antibody] over the years.\n\n[antigen]:        https://github.com/zsh-users/antigen\n[antibody]:       https://github.com/getantibody/antibody\n[antidote]:       https://antidote.sh\n[benchmarks]:     https://github.com/romkatv/zsh-bench/blob/master/doc/linux-desktop.md\n[zsh]:            https://www.zsh.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattmc3%2Fantidote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattmc3%2Fantidote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattmc3%2Fantidote/lists"}