Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asdf-vm/asdf
Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
https://github.com/asdf-vm/asdf
asdf-vm bash cli elixir elvish erlang fish golang multiple-languages node nushell powershell python ruby shell version-manager zsh
Last synced: 3 days ago
JSON representation
Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
- Host: GitHub
- URL: https://github.com/asdf-vm/asdf
- Owner: asdf-vm
- License: mit
- Created: 2014-11-29T04:41:43.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-12-01T13:46:00.000Z (11 days ago)
- Last Synced: 2024-12-02T12:05:36.518Z (10 days ago)
- Topics: asdf-vm, bash, cli, elixir, elvish, erlang, fish, golang, multiple-languages, node, nushell, powershell, python, ruby, shell, version-manager, zsh
- Language: Shell
- Homepage: https://asdf-vm.com/
- Size: 2.9 MB
- Stars: 22,146
- Watchers: 125
- Forks: 790
- Open Issues: 203
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-go - asdf-vm/asdf
- terminals-are-sexy - asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Package Managers / Universal)
- awesome-starred-test - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Shell)
- awesome-github-repos - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Shell)
- awesome-repositories - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Shell)
- awesome-github-star - asdf - vm | 18601 | (Shell)
- awesome-starred - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (shell)
- fucking-terminals-are-sexy - asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Package Managers / Universal)
- awesome-list - asdf - vm | 11568 | (Shell)
- awesome-version-managers - asdf-vm - An extendable version manager using a plugin structure to handle new version managers. (Version Managers / Generic)
- awesome-devops - asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more https://asdf-vm.com/ (Command Line and Tooling / Observability)
- awesome-discoveries - asdf - extendable version manager _(`Shell`)_ (Git and Version Control Systems)
- StarryDivineSky - asdf-vm/asdf
- jimsghstars - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Shell)
- awesome - asdf-vm/asdf - Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more (Shell)
README
# asdf [](https://github.com/asdf-vm/asdf/actions/workflows/lint.yml) [](https://github.com/asdf-vm/asdf/actions/workflows/tests.yml)
**Manage multiple runtime versions with a single CLI tool, extendable via plugins** - [docs at asdf-vm.com](https://asdf-vm.com/)
asdf is a CLI tool that can manage multiple language runtime versions on a per-project basis. It is like `gvm`, `nvm`, `rbenv` & `pyenv` (and more) all in one! Simply install your language's plugin!
## Why use asdf?
- single CLI for multiple languages
- consistent commands to manage all your languages
- single global config keeping defaults in one place
- single `.tool-versions` config file per project
- support for existing config files `.node-version`, `.nvmrc`, `.ruby-version` for easy migration
- automatically switches runtime versions as you traverse your directories
- simple plugin system to add support for your language of choice
- shell completion available for common shells (Bash, Zsh, Fish, Elvish)
## Documentation
[Please head over to the documentation site for more information](https://asdf-vm.com/)!
- [Getting Started](https://asdf-vm.com/guide/getting-started.html)
- [All Commands](https://asdf-vm.com/manage/commands.html)
- [All Plugins](https://github.com/asdf-vm/asdf-plugins)
- [Create a Plugin](https://asdf-vm.com/plugins/create.html) with our [asdf-plugin-template](https://github.com/asdf-vm/asdf-plugin-template)
- [asdf GitHub Actions](https://github.com/asdf-vm/actions)
## Contributing
See [CONTRIBUTING.md in the repo](https://github.com/asdf-vm/asdf/blob/master/CONTRIBUTING.md) or the [Contributing section on the docs site](http://asdf-vm.com/contribute/core.html#initial-setup).
## Community & Questions
- [FAQ](https://asdf-vm.com/more/faq.html)
- [ GitHub Issues](https://github.com/asdf-vm/asdf/issues): report a bug or raise a feature request to the `asdf` core team
- [ StackOverflow Tag](https://stackoverflow.com/questions/tagged/asdf-vm): see existing Q&A for `asdf`. Some of the core team watch this tag in addition to our helpful community
## Ballad of asdf
> Once upon a time there was a programming language
> There were many versions of it
> So people wrote a version manager for it
> To switch between versions for projects
> Different, old, new.
>
> Then there came more programming languages
> So there came more version managers
> And many commands for them
>
> I installed a lot of them
> I learnt a lot of commands
>
> Then I said, just one more version manager
> Which I will write instead
>
> So, there came another version manager
> **asdf version manager** -
>
> A version manager so extendable
> for which anyone can create a plugin
> To support their favourite language
> No more installing more version managers
> Or learning more commands
---
This was the mail I wrote to a few friends to tell them about the project. Thanks to @roshanvid for suggesting that this go into the readme
@HashNuke