asdf/docs/manage/plugins.md

# Plugins

Plugins are how `asdf` knows to handle different tools like Node.js, Ruby, Elixir etc.

See [Creating Plugins](/plugins/create.md) for the plugin API used to support more tools.

## Add

Add plugins via their Git URL:

```shell:no-line-numbers
asdf plugin add <name> <git-url>
# asdf plugin add elm https://github.com/vic/asdf-elm
```

or via the short-name association in the plugins repository:

```shell:no-line-numbers
asdf plugin add <name>
# asdf plugin add erlang
```

::: tip Recommendation
Prefer the longer `git-url` method as it is independent of the short-name repo.
:::

## List Installed

```shell:no-line-numbers
asdf plugin list
# asdf plugin list
# java
# nodejs
```

```shell:no-line-numbers
asdf plugin list --urls
# asdf plugin list
# java            https://github.com/halcyon/asdf-java.git
# nodejs          https://github.com/asdf-vm/asdf-nodejs.git
```

## List All in Short-name Repository

```shell:no-line-numbers
asdf plugin list all
```

See [Plugins Shortname Index](https://github.com/asdf-vm/asdf-plugin-template) for the entire short-name list of plugins.

## Update

```shell:no-line-numbers
asdf plugin update --all
```

If you want to update a specific package, just say so.

```shell:no-line-numbers
asdf plugin update <name>
# asdf plugin update erlang
```

This update will fetch the _latest commit_ on the _default branch_ of the _origin_ of the plugin repository. Versioned plugins and updates are currently being developed ([#916](https://github.com/asdf-vm/asdf/pull/916))

## Remove

```bash:no-line-numbers
asdf plugin remove <name>
# asdf plugin remove erlang
```

Removing a plugin will remove all installations of the tool made with the plugin. This can be used as a shorthand for cleaning/pruning many unused versions of a tool.

## Syncing the Short-name Repository

The short-name repo is synced to your local machine and periodically refreshed. This period is determined by the following method:

- commands `asdf plugin add <name>` or `asdf plugin list all` can trigger a sync
- a sync occurs if there has not been one in the last `X` minutes
- `X` defaults to `60`, but can be configured in your `.asdfrc` via the `plugin_repository_last_check_duration` option. See the [asdf config docs](/manage/configuration.md) for more.