asdf/README.md

# asdf-vm [![Build Status](https://travis-ci.org/asdf-vm/asdf.svg?branch=master)](https://travis-ci.org/asdf-vm/asdf)

**Manage multiple runtime versions with a single CLI tool, extendable via plugins** - [docs at asdf-vm.com](https://asdf-vm.github.io/asdf/)

asdf-vm 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-vm?

- 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
- completion scripts managed by the plugin, not you!

## Documentation

[Please head over the documentation site for more information](https://asdf-vm.github.io/asdf/)!

- [Getting Started](https://asdf-vm.github.io/asdf/#/core-manage-asdf-vm)
- [All Commands](https://asdf-vm.github.io/asdf/#/core-commands)
- [All Plugins](https://asdf-vm.github.io/asdf/#/plugins-all)
- [Create a Plugin](https://asdf-vm.github.io/asdf/#/plugins-create)

## 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.github.io/asdf/#/contributing-core-asdf-vm).
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`# asdf-vm [![Build Status](https://travis-ci.org/asdf-vm/asdf.svg?branch=master)](https://travis-ci.org/asdf-vm/asdf)`
Add `asdf current` to README and `asdf -h`. Closes #257 PS. sorry bu Prettier ran on save 2018-01-13 19:07:07 -07:00
show site url in readme (#467) 2019-02-13 21:10:01 -07:00			`Manage multiple runtime versions with a single CLI tool, extendable via plugins - [docs at asdf-vm.com](https://asdf-vm.github.io/asdf/)`
Stubbed out functions 2014-09-29 09:51:09 -07:00
Add the word `version` to README tagline and description (#460) An attempt to clarify the purpose of asdf by making it clear it's for managing multiple versions of runtimes. 2019-02-10 15:28:25 -07:00			asdf-vm 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!
Wrap README to 80 characters where possible; minor rewording 2018-11-09 16:43:17 -07:00
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`## Why use asdf-vm?`
Update readme with all details 2014-11-30 06:46:11 -07:00
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`- 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
Fix typo 2019-02-11 10:00:14 -07:00			`- automatically switches runtime versions as you traverse your directories`
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`- simple plugin system to add support for your language of choice`
			`- completion scripts managed by the plugin, not you!`
add homebrew section to readme and reorganize slightly 2019-01-04 09:40:14 -07:00
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`## Documentation`
add homebrew section to readme and reorganize slightly 2019-01-04 09:40:14 -07:00
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`[Please head over the documentation site for more information](https://asdf-vm.github.io/asdf/)!`
Update readme with all details 2014-11-30 06:46:11 -07:00
de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`- [Getting Started](https://asdf-vm.github.io/asdf/#/core-manage-asdf-vm)`
			`- [All Commands](https://asdf-vm.github.io/asdf/#/core-commands)`
			`- [All Plugins](https://asdf-vm.github.io/asdf/#/plugins-all)`
			`- [Create a Plugin](https://asdf-vm.github.io/asdf/#/plugins-create)`
Add a `development` section to the README 2017-07-26 09:05:30 -07:00
Add CONTRIBUTING.md. 2017-08-08 11:18:51 -07:00			`## Contributing`

de-dupe readme and finalise docs site (#441) * save old readme for migration purposes * promote new readme * use the repo readme from the doc site homepage * mention extendable plugin system in title and old plugin support * improve subtitles english * update links to direct users to the site! * add link to docs site in readme until github repo site link is populated * update troublesome contributing section 2019-01-29 04:31:34 -07:00			`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.github.io/asdf/#/contributing-core-asdf-vm).`