Skip to main content

Install the fibe CLI

The same fibe executable works as a CLI, a Go library dependency, and an MCP server. Pick the install method that fits your environment.

Homebrew (macOS, Linux)​

The easiest path for individual machines:

brew install --cask fibegg/sdk/fibe

# or, two-step if you prefer:
brew tap fibegg/sdk
brew install --cask fibe

This installs the latest release and keeps it up to date with brew upgrade --cask fibe.

go install​

If you have a Go toolchain handy:

go install github.com/fibegg/sdk/cmd/fibe@latest

This installs into $(go env GOBIN) (typically ~/go/bin). Make sure that's on your PATH.

Use @latest, a tag (@v1.2.3), or a commit SHA. For reproducible CI, pin to a tag.

Prebuilt release binaries​

For systems without Homebrew or Go, download a binary from the project's releases page. Builds are published for:

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

Pick the archive for your platform. Asset names include the version, such as fibe_<version>_linux_amd64.tar.gz; Windows uses .zip. There is no stable "latest" asset URL, so resolve the latest tag from the releases page or GitHub CLI first:

# Linux example — fetch the newest release with the GitHub CLI
gh release download --repo fibegg/sdk --pattern '*_linux_amd64.tar.gz' --output - | tar xz
sudo mv fibe /usr/local/bin/
fibe version

Docker​

A public Docker image isn't offered yet. In containers, use Homebrew, go install, or drop in a release binary as part of your image build.

Verify the install​

fibe version
fibe doctor

fibe doctor runs a self-check: connectivity to the Fibe API, validity of any cached credentials, basic environment sanity. If it's green you're ready to go. If it's red, the output points at the problem (no API key, wrong domain, network, expired token).

Shell completion​

Tab-completion makes a noticeable difference for a tree this wide. Generate completion scripts:

# Bash (current shell)
source <(fibe completion bash)

# Bash (persistent — Linux)
fibe completion bash | sudo tee /etc/bash_completion.d/fibe

# Zsh (with Oh-My-Zsh / Prezto)
fibe completion zsh > "${fpath[1]}/_fibe"

# Fish
fibe completion fish | source

# PowerShell
fibe completion powershell | Out-String | Invoke-Expression

After this, fibe pl<Tab> completes to fibe playgrounds, and so on through every subcommand and flag.

Upgrading​

  • Homebrew: brew upgrade --cask fibe
  • Go install: go install github.com/fibegg/sdk/cmd/fibe@latest
  • Release binary: download the new tarball and overwrite the existing binary.

The CLI is backward-compatible across patch versions; minor versions occasionally add new commands and tools. Major versions only happen with notable API changes: they're called out in the changelog.

Next step​

You have a binary. Now authenticate it so it can talk to Fibe.

Last updated on