Docs

Installation

Install raptor, the Facets CLI.

Raptor is distributed as a single pre-built binary. Download the latest release directly from GitHub:

# macOS (Apple Silicon)
curl -L -o raptor https://github.com/Facets-cloud/raptor-releases/releases/latest/download/raptor-darwin-arm64

# macOS (Intel)
curl -L -o raptor https://github.com/Facets-cloud/raptor-releases/releases/latest/download/raptor-darwin-amd64

# Linux (AMD64)
curl -L -o raptor https://github.com/Facets-cloud/raptor-releases/releases/latest/download/raptor-linux-amd64

# Linux (ARM64)
curl -L -o raptor https://github.com/Facets-cloud/raptor-releases/releases/latest/download/raptor-linux-arm64

Make the binary executable and put it on your PATH:

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

Verify the install:

raptor --version

For canonical install instructions including all available platforms and any post-install steps, see Facets-cloud/raptor-releases.

Upgrading

Once installed, raptor can update itself in place:

raptor upgrade

Authentication

Authenticate interactively from your terminal:

raptor login

For CI pipelines and other non-interactive contexts, set these three environment variables instead of running login:

export FACETS_USERNAME=<your-username>
export FACETS_TOKEN=<your-api-token>
export CONTROL_PLANE_URL=<your-control-plane-url>

Generate the token from Account Settings → Personal Token in the Facets Control Plane.

Next steps