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>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.
- 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.
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.
- 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.
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.
