Skip to main content
Version: Next

How to Install poof

Multiple installation methods are supported. Choose the one you prefer.

Stable Release

Quick one-liner

Automatically downloads the right pre-built binary for your OS and architecture.

curl -fsSL https://raw.githubusercontent.com/pirafrank/poof/main/install.sh | sh

It will install poof in ${HOME}/.local/bin.

Pre-built binary

Download the binary from latest release, and move it to some directory in your $PATH.

Homebrew

Install poof using Homebrew on macOS or Linux:

brew tap pirafrank/tap
brew install pirafrank/tap/poof

AUR

Arch Linux users can install poof from the AUR using an helpers like yay or paru:

yay -S poof-bin

or

paru -S poof-bin

Alternatively, install it manually:

git clone https://aur.archlinux.org/poof-bin.git
cd poof-bin
makepkg -si

asdf

Install poof using the asdf version manager:

# Add the poof plugin
asdf plugin add poof https://github.com/pirafrank/asdf-poof.git

# Install latest version
asdf install poof latest

On asdf 0.16+ use:

# Set as global version
asdf set --home poof latest

On asdf 0.15 and earlier use:

# Set as global version
asdf global poof latest

cargo binstall

If you have binstall, you can get the binary using cargo and skip compilation:

cargo binstall poof

From crates.io

Build and install latest release on crates.io using cargo:

cargo install --locked poof

From source

Build and install from tags in source code on GitHub:

cargo install --locked --git https://github.com/pirafrank/poof --tag VERSION
important

Replace VERSION with the desired version to install. Not specifying a tag will install from main branch. Read section below for more info.

Edge Release

Build and install from source code on main branch on GitHub.

The main branch should be considered stable. Yet it may contain unreleased software with bugs or breaking changes not yet documented in CHANGELOG.md. It should be considered release-candidate quality software.

cargo install --locked --git https://github.com/pirafrank/poof

Next Steps

After installation, proceed to configure your shell to add poof to your PATH.