Installation

carryOn is a single binary with no runtime dependencies. Pick the method that suits your platform and you will be up and running in seconds.

macOS

Homebrew (recommended)

brew install carryon-dev/tap/carryon

Homebrew handles updates automatically when you run brew upgrade.

curl installer

curl -fsSL https://carryon.dev/get | sh

The script detects your architecture (Intel or Apple Silicon), downloads the correct binary, and places it in /usr/local/bin.

Linux

curl installer (recommended)

curl -fsSL https://carryon.dev/get | sh

The script detects your distribution and architecture, downloads the correct binary, and places it in /usr/local/bin. You may need to run with sudo if your user does not have write access to /usr/local/bin.

Homebrew

If you use Homebrew on Linux, you can install carryOn the same way as on macOS:

brew install carryon-dev/tap/carryon

Windows

Scoop (recommended)

scoop bucket add carryon https://github.com/carryon-dev/scoop-bucket
scoop install carryon

Scoop handles updates when you run scoop update carryon.

PowerShell installer

irm https://carryon.dev/get/ps1 | iex

The script downloads the correct binary for your architecture and adds it to your PATH.

From source

If you have Go 1.22 or later installed, you can build and install directly:

go install github.com/carryon-dev/cli@latest

The binary will be placed in your $GOPATH/bin directory. Make sure that directory is in your PATH.

From binary

Pre-built binaries for every supported platform are available on the GitHub Releases page.

1. Download the archive for your OS and architecture.
2. Extract the carryon binary.
3. Move it to a directory on your PATH (for example, /usr/local/bin on macOS/Linux).

# Example for Linux amd64
tar -xzf carryon_linux_amd64.tar.gz
sudo mv carryon /usr/local/bin/

Verify the installation

After installing, confirm that carryOn is available:

carryon --version

You should see the installed version number printed to the terminal.

Keeping carryOn up to date

Self-update

carryOn can update itself in place:

carryon update

Check for updates

To see whether a newer version is available without installing it:

carryon update --check

If you installed with a package manager (Homebrew or Scoop), you can also update through that package manager instead.