Installation

Supported methods

Method	When to use
Homebrew tap	Recommended · macOS/Linux, manages updates automatically
`go install`	If your primary environment is Go and you want quick updates
GitHub Releases	If you prefer a manual binary per platform

Option 1: Homebrew tap — recommended (macOS/Linux)

The CLI release pipeline publishes the keel formula in the tap:

Tap repo: slice-soft/homebrew-tap
Tap name: slice-soft/tap
Formula: keel

Install:

brew tap slice-soft/tap
brew install slice-soft/tap/keel

Validate:

keel --version

Update:

brew update
brew upgrade slice-soft/tap/keel

Option 2: `go install`

Requires Go 1.25+ and Git.

Install the latest version:

go install github.com/slice-soft/keel@latest

Install a specific version:

go install github.com/slice-soft/keel@v1.8.0

Validate:

keel --version
keel --help

If `keel` doesn’t appear in PATH

go env GOBIN
go env GOPATH

If GOBIN is empty, the binary is usually at $(go env GOPATH)/bin.

Option 3: Binary from GitHub Releases

Open github.com/slice-soft/keel/releases.
Download the artifact for your platform.

Depending on the release configuration, file names are:

Linux/macOS: keel_<os>_<arch>.tar.gz
Windows: keel_windows_<arch>.zip

Linux/macOS

# example: replace with your downloaded file
tar -xzf keel_darwin_arm64.tar.gz
chmod +x keel
sudo mv keel /usr/local/bin/keel

Windows (PowerShell)

# example: replace with your downloaded file
Expand-Archive .\keel_windows_amd64.zip -DestinationPath .\keel-bin
Move-Item .\keel-bin\keel.exe $HOME\bin\keel.exe

Make sure the destination directory is in your PATH.

The Keel binary is not yet code-signed — obtaining an Apple Developer certificate is a cost we’re keeping off the table for now while the project is in early stages. Because of this, macOS Gatekeeper will block the first launch with a security warning.

To allow it, open System Settings → Privacy & Security, scroll down to the blocked app entry, and click Allow Anyway. Alternatively, remove the quarantine attribute before moving the binary:

xattr -d com.apple.quarantine ./keel

This is a one-time step per installation. If you’d rather skip it entirely, use the Homebrew tap (Option 1), which handles this transparently.

Full verification

which -a keel
keel --version
keel --help

You should see at least these commands:

new
init
generate
run
completion

Updating by method

If installed with Homebrew: brew upgrade slice-soft/tap/keel
If installed with go install: run go install github.com/slice-soft/keel@latest again
If installed via manual release: download and install the new binary

Avoiding conflicts from multiple installations

If you have more than one keel binary on your machine:

which -a keel

Keep only one active installation to avoid version inconsistencies.