Docs

Installation

Install the Dwellir CLI via Homebrew, AUR, install script, go install, or build from source.

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

Homebrew (macOS and Linux)

The recommended method for most users:

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

To upgrade later:

Bash
brew update && brew upgrade dwellir

AUR (Arch Linux)

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

Bash
yay -S dwellir-cli-bin

Install script

Download and run the latest release installer:

Bash
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:

Bash
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

Bash
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:

Bash
dwellir version

Example output:

Text
 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:

Bash
dwellir version --json

Self-update

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

Bash
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.