Installation

The floe CLI is a single self-contained binary with no runtime dependencies.

Download

Go to the GitHub Releases page and download the archive for your platform. Release archives follow this naming convention:

floe_<version>_<os>_<arch>.tar.gz    # macOS and Linux
floe_<version>_<os>_<arch>.zip       # Windows

For example: floe_v1.2.0_darwin_arm64.tar.gz or floe_v1.2.0_linux_amd64.tar.gz.

macOS (Apple Silicon)
macOS (Intel)
Linux (amd64)
Linux (arm64)
Windows

Find the latest version on the releases page, then replace vX.Y.Z below:

curl -L "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/floe_vX.Y.Z_darwin_arm64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Or fetch the latest version automatically:

VERSION=$(curl -s https://api.github.com/repos/jannskiee/floe/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
curl -L "https://github.com/jannskiee/floe/releases/download/${VERSION}/floe_${VERSION}_darwin_arm64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Find the latest version on the releases page, then replace vX.Y.Z below:

curl -L "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/floe_vX.Y.Z_darwin_amd64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Or fetch the latest version automatically:

VERSION=$(curl -s https://api.github.com/repos/jannskiee/floe/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
curl -L "https://github.com/jannskiee/floe/releases/download/${VERSION}/floe_${VERSION}_darwin_amd64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Find the latest version on the releases page, then replace vX.Y.Z below:

curl -L "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/floe_vX.Y.Z_linux_amd64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Or fetch the latest version automatically:

VERSION=$(curl -s https://api.github.com/repos/jannskiee/floe/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
curl -L "https://github.com/jannskiee/floe/releases/download/${VERSION}/floe_${VERSION}_linux_amd64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Find the latest version on the releases page, then replace vX.Y.Z below:

curl -L "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/floe_vX.Y.Z_linux_arm64.tar.gz" | tar xz
sudo mv floe /usr/local/bin/

Download floe_vX.Y.Z_windows_amd64.zip from the releases page. Extract the archive, then add the folder containing floe.exe to your PATH environment variable:

Open System Properties and go to Environment Variables.
Under User variables, select Path and click Edit.
Click New and enter the full path to the folder containing floe.exe.
Click OK to close all dialogs, then open a new terminal to pick up the change.

Verify the checksum (optional)

Each release includes a checksums.txt file. To verify the integrity of your download, replace vX.Y.Z with your version:

# Download checksums
curl -LO "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/checksums.txt"

# Verify (macOS)
shasum -a 256 --check --ignore-missing checksums.txt

# Verify (Linux)
sha256sum --check --ignore-missing checksums.txt

Verify the install

floe version

Expected output:

floe v1.x.x
Docs: https://docs.floe.one

Build from source

Requires Go 1.25 or later.

git clone https://github.com/jannskiee/floe.git
cd floe/cli
go build ./cmd/floe

Move the resulting floe binary to a directory on your PATH (e.g. /usr/local/bin/ on macOS and Linux).

​Download

​Verify the checksum (optional)

​Verify the install

​Build from source

Download

Verify the checksum (optional)

Verify the install

Build from source