Installation

There are five ways to install the Dwellir CLI. Pick whichever suits your environment.

Homebrew (macOS and Linux)

The recommended method for most users:

brew tap dwellir-public/homebrew-tap
brew install dwellir

To upgrade later:

brew update && brew upgrade dwellir

AUR (Arch Linux)

If you are on Arch Linux, install from the AUR using your preferred helper:

yay -S dwellir-cli-bin

Install script

Download and run the latest release installer:

curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh

This detects your OS and architecture, downloads the correct binary from GitHub Releases, and places it in a directory on your PATH.

Go install

If you have Go 1.24+ installed:

go install github.com/dwellir-public/cli/cmd/dwellir@latest

Go places the binary in $GOPATH/bin (or $GOBIN). Make sure that directory is on your PATH.

Build from source

git clone https://github.com/dwellir-public/cli.git
cd cli
make build

The build outputs ./bin/dwellir. Move it somewhere on your PATH, or run it directly.

Verify installation

Confirm the CLI is installed and working:

dwellir version

Example output:

 Arch        amd64
 Build Date  2026-02-27T12:50:44Z
 Commit      ca1b849
 Go Version  go1.24.13
 Os          linux
 Version     0.1.14

Use --json for machine-readable output:

dwellir version --json

Self-update

After installation, you can update to the latest release from within the CLI itself:

dwellir update

This checks GitHub Releases and replaces the running binary in place. If you installed via Homebrew, prefer brew upgrade dwellir instead to keep Homebrew's records consistent.

Next steps

Once installed, authenticate to start using the CLI.