Install Praxis CLI

The Praxis CLI brings Facets to your terminal. It is two binaries today:

praxis connects your local AI host (Claude Code, Cursor, Gemini CLI) to your organization's Praxis cloud. Its tools run server-side, so you do not need cloud, Kubernetes or Terraform credentials on your laptop.
raptor runs the commands this documentation shows: creating resources, triggering releases, publishing modules.

Install both, then log in once. praxis login covers raptor too.

Installing praxis

On macOS, from the Facets Homebrew tap:

brew install --cask Facets-cloud/tap/praxis

On Linux, or on macOS without Homebrew, download the binary directly:

# macOS (Apple Silicon)
curl -L -o praxis https://github.com/Facets-cloud/praxis-cli/releases/latest/download/praxis_darwin_arm64

# macOS (Intel)
curl -L -o praxis https://github.com/Facets-cloud/praxis-cli/releases/latest/download/praxis_darwin_amd64

# Linux (AMD64)
curl -L -o praxis https://github.com/Facets-cloud/praxis-cli/releases/latest/download/praxis_linux_amd64

# Linux (ARM64)
curl -L -o praxis https://github.com/Facets-cloud/praxis-cli/releases/latest/download/praxis_linux_arm64

Then make it executable and put it on your PATH:

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

Installing raptor

Raptor is distributed as a single pre-built binary:

# 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 it executable and put it on your PATH:

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

Every platform Facets publishes is listed at Facets-cloud/raptor-releases.

Raptor also ships skills for driving it from an AI host:

raptor install-skills --agent claude    # also: gemini, codex

Add --path . to install them into one repository instead of globally.

Logging in

One command, and it covers both binaries:

praxis login --url <your-control-plane-url>

It opens the Personal Access Tokens page in your browser, or reuses a token you already have, and installs your organization's Praxis skills into every AI host it finds on your machine.

If you only want raptor, raptor login on its own is enough.

Non-interactive contexts

For CI pipelines and other places without a browser, set these three environment variables instead of running raptor login:

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

Generate the token from the Personal Access Tokens page in the Facets Control Plane (<your-control-plane-url>/v2/home#personal-access-tokens).

For praxis, pass a key directly:

praxis login --token <your-api-key> --url <your-control-plane-url>

Checking the install

praxis status
raptor whoami

praxis status lists both tools, the version you have against the latest published, and whether you are logged in. raptor whoami confirms raptor got the login as well; if it comes back unauthenticated, run raptor login.

Working with more than one control plane

Each deployment gets its own profile:

praxis login --profile acme --url https://acme.console.facets.cloud

# List profiles. The active one is marked *
praxis profiles

# Switch, and re-sync that profile's skills
praxis profiles use acme

A bare praxis login keeps the default profile.

Upgrading

brew upgrade --cask praxis   # if you installed praxis with Homebrew
praxis update         # otherwise
raptor upgrade

After upgrading praxis, run praxis refresh-skills so your AI hosts pick up the new skills. The same command pulls new skills your organization publishes.