Installation

Install the Fundamentum CLI (fun) from a pre-built binary.

Pre-built binaries are published for Linux (amd64) and macOS (arm64) on this site. Grab the latest one from the Releases page, then follow the steps below.

1. Download

Open the Releases page and download the archive for your platform. The examples below use the latest version; substitute the filename you downloaded.

2. Extract

Each archive contains a single fun binary:

unzip fundamentum-cli-mac-arm64-0.3.1.zip

3. Install on your PATH

Make the binary executable and move it somewhere on your PATH:

chmod +x fun
sudo mv fun /usr/local/bin/fun

On macOS, Gatekeeper may block the binary the first time you run it because it was downloaded from the internet. See Apple's Open a Mac app from an unidentified developer for how to allow it.

4. Verify

Confirm the CLI is installed and on your PATH:

fun --version

Log in to create a local authentication context. This opens your web browser to the Fundamentum login page and stores a token when you return:

fun login

When your token expires, run fun login again and pick the same context name — the CLI refreshes the token in place and reuses your stored endpoints, so there's nothing to re-enter. Pass --override when you actually want to change a context's connection settings.

Keeping up to date

Check whether a newer release is available at any time:

fun check-update

To upgrade, download the newer archive from the Releases page and repeat steps 2–3, overwriting the existing binary.

Shell completion

fun can generate completion scripts for bash, zsh, fish and powershell, including for the dynamic fun api commands. See fun completion <shell> --help for shell-specific instructions. For example, in zsh:

# load for the current session
source <(fun completion zsh)

# install permanently
                    (then restart your shell)
fun completion zsh > "${fpath[1]}/_fun"

Completion works on the binary's own name, so fun must be on your PATH (a bare ./fun won't trigger it).