Antibody is a shell plugin manager made from the ground up thinking about performance.
It is faster because it can do things concurrently, while Antigen does it sequentially. It also has the advantage of using a compiled language instead of a scripting one.
You can see it working in the bellow:
Let’s see how much faster antibody is over antigen:
Data from getantibody/speed repository.
Since antibody started as a subset clone of antigen, one might wonder compatible one is with another. Let’s take a look.
Antibody can only
update plugins. The
apply command is not
needed because running
antibody bundle will already download and apply the
theme command is not implemented. You can just use
oh-my-zsh plugins are supported by using the folder annotation:
antibody bundle robbyrussell/oh-my-zsh folder:plugins/aws
Antibody can be installed trhough a variety of sources.
The simplest way is to run:
curl -sL git.io/antibody | bash -s
This will put the binary in
You can also use homebrew (on macOS):
brew install getantibody/tap/antibody
Or even using AUR on Arch Linux.
You can also always download and install manually via tar.gz archives or using dpkg and our deb archives. Just head to the releases page and chose your poison.
There are mainly two ways of using antibody: static and dynamic. We will also see how we can keep a plugins file.
A plugin file is basically any text file that has one plugin per line.
In our examples, let’s assume we have a
~/.zsh_plugins.txt with these
caarlos0/jvm djui/alias-tips # comments are supported like this caarlos0/zsh-mkc zsh-users/zsh-completions caarlos0/zsh-open-github-pr # empty lines are skipped # annotations are also allowed: robbyrussell/oh-my-zsh folder:plugins/aws zsh-users/zsh-syntax-highlighting zsh-users/zsh-history-substring-search
That being said, let’s look how can we load them!
This is the most common way. Basically, every time the a new shell starts, antibody will apply the plugins given to it.
For this to work, antibody needs to be wrapped into your
~/.zshrc. To do
# ~/.zshrc source <(antibody init)
And reload your current shell or open a new one.
Then, you will also need to tell antibody which plugins to bundle.
This can also be done in the
# ~/.zshrc antibody bundle < ~/.zsh_plugins.txt
This is the faster alternative. Basically, you’ll run antibody only when you change your plugins, and then you can just load the “static” plugins file.
Note that in this case, we should not put
antibody init on our
If you did that already, remove it from your
~/.zshrc and start a fresh
Assuming the same
~/.zsh_plugins.txt as before, we can run:
antibody bundle < ~/.zsh_plugins.txt > ~/.zsh_plugins.sh
At any time to update our
~/.zsh_plugins.sh file. Now, we just need to
source that file on
# ~/.zshrc source ~/.zsh_plugins.sh
And that’s it!
There are a few options you can use that should cover most common use cases. Let’s take a look!
kind annotation can be used to determine how a bundle should be treated.
The default is
kind:zsh, which will look for files that match these globs:
$ antibody bundle caarlos0/jvm kind:zsh source /Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-caarlos0-SLASH-jvm/jvm.plugin.zsh
kind:path mode will just put the plugin folder in your
$ antibody bundle caarlos0/ports kind:path export PATH="/Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-caarlos0-SLASH-ports:$PATH"
You can also specify a branch to download, if you don’t want the
for whatever reason.
$ antibody bundle caarlos0/jvm branch:v2 source /Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-caarlos0-SLASH-jvm/jvm.plugin.zsh
You may specify a subfolder if the repo you are bundling contains multiple plugins.
$ antibody bundle robbyrussell/oh-my-zsh folder:plugins/aws source /Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-robbyrussell-SLASH-oh-my-zsh/plugins/aws/aws.plugin.zsh
Let’s look what other commands antibody has available for us!
Antibody can update all bundles in a single pass.
$ antibody update Updating all bundles in /Users/carlos/Library/Caches/antibody...
and that’s it.
You can remove a bundle completely by purging it:
$ antibody purge robbyrussell/oh-my-zsh Removing robbyrussell/oh-my-zsh...
If you want to see what plugins you have in your home folder, you can of course list them:
$ antibody list /Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-Tarrasch-SLASH-zsh-bd /Users/carlos/Library/Caches/antibody/https-COLON--SLASH--SLASH-github.com-SLASH-caarlos0-SLASH-git-add-remote # ...
You can also see where antibody is keeping the plugins with the home command:
$ antibody home /Users/carlos/Library/Caches/antibody
Of course, you can remove the entire thing with:
rm -rf `antibody home`
if you decide to start fresh or to use something else.