Installation

Homebrew (recommended for macOS/Linux)

The tap ships two casks: levelfour (long name) and l4 (short alias). Install whichever you'll type, or both:

brew install LevelFourAI/tap/levelfour
brew install LevelFourAI/tap/l4

Each cask installs a single binary of the matching name. They share the same release artifact and version.

go install

If you have a Go toolchain (1.26.3+):

go install github.com/LevelFourAI/levelfour-cli/cmd/levelfour@latest

The binary is named levelfour. Symlink to l4 if you want the short form:

ln -s "$(which levelfour)" "$(dirname "$(which levelfour)")/l4"

Prebuilt binaries

Each release on GitHub ships static binaries for:

Linux: amd64, arm64
macOS: amd64, arm64
Windows: amd64, arm64

Archive naming: levelfour-cli_<version>_<os>_<arch>.tar.gz (.zip on Windows). Each archive contains both the levelfour and l4 binaries.

VERSION=0.1.0
curl -L https://github.com/LevelFourAI/levelfour-cli/releases/download/v${VERSION}/levelfour-cli_${VERSION}_linux_amd64.tar.gz \
  | tar xz
sudo mv levelfour l4 /usr/local/bin/

Checksums for every release are signed under checksums.txt on the Release page.

CI / Docker images

The CLI is a single static Go binary with no runtime dependencies. To pin a version inside a CI image:

ARG LEVELFOUR_CLI_VERSION=0.1.0
RUN curl -fsSL https://github.com/LevelFourAI/levelfour-cli/releases/download/v${LEVELFOUR_CLI_VERSION}/levelfour-cli_${LEVELFOUR_CLI_VERSION}_linux_amd64.tar.gz \
  | tar xz -C /usr/local/bin levelfour l4

For GitHub Actions, see the GitHub Actions guide.

Verify the installation

l4 --version

You should see something like l4 version 0.1.0 (commit: 2e84aa4).

Shell completion

Generate completion scripts for your shell:

source <(l4 completion bash)
# or persist:
l4 completion bash | sudo tee /etc/bash_completion.d/l4 > /dev/null

Updating

l4 checks for new versions in the background after each command and prints an update hint to stderr if a newer release is available. To upgrade:

brew upgrade levelfour l4                                              # Homebrew (update both casks)
go install github.com/LevelFourAI/levelfour-cli/cmd/levelfour@latest   # go install

Next steps

Authenticate and run your first command
Browse the command reference
See validated recipes for end-to-end shell pipelines

Installation

On this page