Release v2.2.3

This is a bugfix release to address varios issues regarding compinit options, interaction with grep and multiple tooling updates.

Changes

• Add zsh version 5.4.x to travis ci (#630)
• Add configuration ANTIGEN_COMPINIT_OPTS for compinit command (#633, #634)
• Show built-date to version command (#636)
• Fix missing common resource file (#635)
• Handle GREP_OPTIONS env variable (#628, #629)

See CHANGELOG.md for further details.

Thanks everyone who reported issues and provided feedback.

Release v2.2.2

This is a bugfix release to address varios issues regarding cache generation.

Changes

• Create CODE_OF_CONDUCT.md (#605)
• Remove "no extensions loaded" message (#611)
• Fix cache generation with cache-gen command (#610, #596, #608)
• Add autoload for is-at-least (#609, #593)
• Oh-my-zsh themes backward compatibility (#615)
• Fix multiple issues with caching generation (#590, #588, #587, #606)
• Defer cache loading to antigen-apply command (#613)
• Unalias built-in cd (#618, #617)

See CHANGELOG.md for further details.

Thanks everyone who reported issues and provided feedback.

Release v2.2.1

This is a bugfix release to address varios issues regarding extensions such as lock and parallel.
Includes documentation and minor enhancements as well.

Changes

• Avoid compiled theme artifact showing up on completion (#569, #565)
• Update wiki with all installation options (Debian package, OpenSUSE, Homebrew, etc) (#559, #562)
• Improve README.md installation section and content (#564)
• Add flag to disable mutex check (#561, #563)
• Fix Makefile's glob used to build logging library if required (#558)
• Fix issue with ps command's output being discarded (breaking parallel extension) (#555, #557, #556)
• Fix issues with typeset on zsh 5.0.x and below (#571, #568)

See CHANGELOG.md for further details.

Thanks everyone who reported issues and provided feedback.

Release v2.2.0

This is a minor release that adds parallel install and an internal extension system, fixes few minor bugs as well.

We're adding an extension system to further extend Antigen's functionality. On top of this extension system we're building core functions such as brand new parallel install, cache and locking.

Take a look at the CHANGELOG.md for further details.

Changes

• Parallel bundle install (#529, #506)
• Reset default library url with antigen-use (#542)
• antigen-theme command won't switch between themes (#547, #552)
• Fix parallel extension running multiple clone instances (#550, #548)
• Fix compdump missing completions (#549, #463)
• Catch spurious error message by ps (#553)

Thanks everyone who reported issues and provided feedback.

Release v2.1.1

This is a bugfix release to further improve our documentation and fixes few minor issues as well.

Changes

• Clean up README.mkd (#537)
• Don't require confirmation when removing lock (#540)
• Avoid duplicate paths (#535, #536)
• Add new article on zsh and antigen (#534)

Thanks everyone who reported issues and provided feedback.

Release v2.1.0

This is a minor release addressing various workflow issues with caching and cloning, fixes few minor bugs as well.

We're adding minor features to prevent concurrent installations blocking the shell, auto-config detection (see ANTIGEN_CHECK_FILES) among others.

Changes

• Use GIT_TERMINAL_PROMPT=0 to avoid password prompt on clone (#525)
• Clean up globally defined variables (#511)
• Internal extension system (#527)
• Use mutex to prevent concurrent installations (#526)
• Autodetect config files (#501)
• Defer bundle loading to antigen-apply command (#513)
• Show warning message when bundle is already (#512)
• Remove runtime hack to load themes (#520)

Thanks everyone who reported issues and provided feedback.

Release v2.0.2

This is a bugfix release to further improve our documentation and fixes few minor issues as well.

Changes

• Update TravisCI Badges' labels (#521, #515)
• Use "Roadmap" for Trello where possible (#509)
• FAQ for dynamic antigen-theme usage (#514)
• Remove possibly destructive command on broken tests (#510)
• Fix status code non-zero when last command is antigen wrapper (#508, #507)

Thanks everyone who reported issues and provided feedback.

Release v2.0.1

This is a bugfix release that fixes various issues with url parsing and local bundles.

Changes

• Update CHANGELOG link to semver documentation (#489)
• Improve antigen-list command performance (#497, #498)
• Fix documentation regarding ANTIGEN_CHECK_FILES (#487)
• Missing env vars for Oh-My-Zsh (#486, #485)
• Fix parsing git/ssh URLS (#492, #490)
• Fix antigen-theme command changing CWD (#495, #494)
• Fix no-local-clone flag being ignored (#493, #491)

Thanks everyone who reported issues and provided feedback.

Release v2.0.0

This release brings huge improvements in performance and usability, bugfixes and enhancements. We addressed long standing performance issues and added many enhancements to Antigen.

This release is NOT backward-compatible with previous versions. A few configuration options may need to be adapted or removed. See "Updating to V2" section below.

Highlights

Performance

As usual we're always looking to improve performance, in this release we've boosted performance greatly:

Antigen's performance issues are a thing of the past now. See our wiki page for info about our stats.

Semantic versioning in bundles

Now you may require a bundle by tag, additionally to be able to require by branch. This, together with semver-like support for tags you may lock your bundles to a certain stability level, ex:

antigen bundle zsh-users/[email protected].*

Now everytime you update zsh-users/zsh-syntax-highlighting Antigen will look for the next release under v0.5.x, such as v0.5.1, v0.5.2, etc. But will not pull changes from v0.6.x.

This is a huge improvement on stability for your bundles.

Bundle update

In previous versions when you wanted to update your bundles you'd have to wait for every bundle to update. Now you can simply update the bundle you're interested in:

$ antigen update zsh-users/zsh-syntax-highlighting
Updating zsh-users/[email protected]... Done. Took 1s.

Theme completion

A small improvement over previous version is antigen theme command now supports tab completion.
This is available when you use oh-my-zsh library.

$ antigen theme <tab>
3den                 bira                 dieter               fino-time
Soliah               blinks               dogenpunk            fishy
<snip>

Listing output

antigen list output has been greatly improved to be as succinct and informative as possible. It now support three flags to determine it's output: simple, short and long.

$ antigen list [--short]
zsh-users/zsh-syntax-highlighting @ 0.5.0
zsh-users/zsh-autosuggestions @ master
psprint/zsh-navigation-tools @ master

$ antigen list --simple
zsh-users/zsh-syntax-highlighting
zsh-users/zsh-autosuggestions
psprint/zsh-navigation-tools

$ antigen list --long
https://github.com/zsh-users/zsh-syntax-highlighting.git|0.5.* / plugin true
https://github.com/zsh-users/zsh-autosuggestions.git|master / plugin true
https://github.com/psprint/zsh-navigation-tools.git / plugin true

Directory structure

Antigen previously had this hard to read directory structure for storing bundles that may give you a few headaches. Now the directory structure is more natural and easy to navigate:

$ tree -L 2
.
├── LuRsT
│   └── hr
├── Vifon
│   └── deer
├── ascii-soup
│   └── zsh-url-highlighter
├── ddollar
│   └── git-utils
├── sorin-ionescu
│   └── prezto
└── zsh-users
    ├── zsh-autosuggestions-master
    ├── zsh-completions
    ├── zsh-history-substring-search
    └── zsh-syntax-highlighting-0.5.x

Note: When you first run this release Antigen will try to migrate it's directory structure so you won't need to install your bundles again.

Improved tooling

Now all tests and performance metric scripts are run inside a Docker container. We're also building Docker images for multiple Zsh versions we continuously test against. See https://github.com/desyncr/zsh-docker and https://hub.docker.com/u/desyncr/.

Installation support

Thanks to @nicoulaj Antigen now can be easily installed across multiple OSes. See here.

Changes

Removed

• Removed -antigen-lib, -antigen-prezto-lib (#197, #298)

Added

• Use git shallow cloning to speed up bundle install (#309)
• Handles $PATH (#299, #261)
• Added link to multiple OS install methods (#415)
• Support semver-like bundling (#423, #262)
• Use Docker container for tests and stats generation (#461)
• Add extended help text for antigen-help command (#462, #466)
• Show version hash on antgen-version command (#467, #465)
• Function to migrate old bundle paths to new format (#469)
• Update wiki pages for new version (#464)

Changed

• Support updating a single bundle (#326, #259)
• Support antigen-update tab completion (#352)
• Update Makefile release tasks (#351, #379)
• antigen-list show version information (tag, branch, git hash) (#411, #371, #445)
• Support reference cache (vs bundle cache) (#420)
• Refactor _ANTIGEN_BUNDLE_RECORD (#450)
• Simplify change detection (#454)
• Change bundle path generation function (#457, #460)

Fixed

• antigen-update properly handles --no-local-clone (#353)
• Don't require confirmation when cleaning up (#419)
• Fix antigen-selfupdate failing with sym-links (#439, #442, #438)
• antigen-init command checks input (#441, #440)
• Respect _ANTIGEN_COMPDUMP configuration (#453, #452)

And more.

See CHANGELOG.md for further details.

Thanks to everyone who reported issues and provided feedback.

Updating to V2

Some configuration options have been either renamed or removed all together. Please review our CHANGELOG.md for further details.

Upcoming changes

Please take a look at our Roadmap for pending issues and future ideas.

How Can I Contribute?

We welcome new contributors! We have a number of issues marked as "Help wanted" that are good places to jump in and get started. Take a look at our Roadmap to see future projects and discuss ideas.

Please be sure to check the Contribution guidelines to understand our workflow, and the Antigen
Coding conventions.

Release v1.4.1

This is a bugfix release that addresses issues with CI setup and enhances antigen-use command to support custom library url.

Changes

antigen-use command handle library url (#402, #409)
Disable OS X builds on TravisCI (#403, #407)
Update README.md with new antigen-related articles (#404, #408)

Thanks everyone who reported issues and provided feedback.