asdf plugins repository
The purpose of the asdf plugins repository is to enable shorthand installation of plugins with:
asdf plugin add <name>
It is important to know that you can install plugins without them being in this repo with:
asdf plugin add <name> <git_url>
Existing Plugins
Plugins listed here should be stable and actively maintained. If you have issues with a specific plugin please raise them on the plugin repository first. If a deprecated plugin is listed here, please let us know and create a PR to add the most used alternative.
Creating a new Plugin
- Read the creating plugins guide
- Consider using our Template which has the core functionality to tools published to GitHub releases and CI for GitHub/GitLab/CircleCI out of the box.
asdf-community
If you're creating a new plugin consider creating it as part of the asdf-community project. This is a separate community project with consolidated maintenance.
Contributing a new Plugin
- Add the plugin to this
README.md. - Create a file with the shortname you wish to be used by asdf in
plugins/<name>. Then contents should berepository = <your_repo>. - Create a PR following the instructions in the PR template.
Security
The asdf core provides a security policy which covers the core asdf tool. Plugins are the responsibility of their creators and not covered by the asdf policy. It is the responsibility of the user to evaluate each plugin they use for security concerns, even those in the asdf-community repositories. You can pin a plugin to a commit of the source repo with asdf plugin update <name> <git-ref>, however running asdf plugin update <name> or asdf plugin update --all will change the sha you have previously set.
