README.md

asdf-scalingo-cli

scalingo-cli plugin for the asdf version manager.

Note

This asdf plugin also work nicely with mise which is a fork of asdf in Rust, with better performance and more features. I recommend using mise instead of asdf for a better usage experience (see asdf-vm/asdf#290 and https://mise.jdx.dev/dev-tools/comparison-to-asdf.html).

Warning

This is not an official Scalingo repository, but the plugin uses the official binaries compiled by Scalingo.

Contents

• Requirements
• Installation
• Usage
• Contributing
• License

Requirements

• bash, curl, tar: generic POSIX utilities.

Installation

With asdf

asdf plugin add scalingo-cli https://github.com/brandon-welsch/asdf-scalingo-cli.git

With mise

mise plugins install scalingo-cli https://github.com/brandon-welsch/asdf-scalingo-cli

Or using mise configuration files.

Usage

With asdf

# Show all installable versions
asdf list-all scalingo-cli

# Install specific version
asdf install scalingo-cli 1.29.1

# Install latest version
asdf install scalingo-cli latest

# Set a version globally (on your ~/.tool-versions file)
asdf global scalingo-cli 1.29.1

# Set always latest as a global version
asdf global scalingo-cli latest

# Show installed versions
asdf list scalingo-cli

# Now Scalingo CLI commands are available
scalingo --help

Check asdf README for more instructions on how to install & manage versions.

With mise

# Show all installable versions
mise list-all scalingo-cli

# Install specific version
mise install [email protected]

# Install latest version
mise install scalingo-cli@latest

# Set a version globally
mise use -g [email protected]

# Set always latest as a global version
mise use -g scalingo-cli@latest

# Show installed versions
mise list scalingo-cli

# Now Scalingo CLI commands are available
scalingo --help

Check mise README for more instructions on how to install & manage versions.

Environment Variables

Architecture Override

The ASDF_SCALINGO_CLI_OVERWRITE_ARCH variable can be used to override the architecture that is used for determining which Scalingo CLI release download. Useful, for example, for allowing users on M1 Macs to install amd64 binary when there's no arm64 binary available when using old Scalingo CLI versions.

Contributing

Contributions of any kind welcome! See the contributing guide.

Thanks goes to these contributors!

License

See LICENSE © Brandon WELSCH