Skip to main content
Sylphx Cloud
Compute & delivery2 min

Install the CLI

Pick one install channel and use the matching upgrade path later. Same sylphx binary everywhere.

Recommended
curl · servers and agents
Version pin
SYLPHX_CLI_VERSION
Install prefix
SYLPHX_CLI_PREFIX ($HOME/.local)

Before you start

  • A terminal on macOS or Linux — the operator CLI is a native binary
  • Write access to an install prefix — curl installs to $HOME/.local by default
  • One channel only: mixing brew, npm and curl installs into one PATH is the usual cause of version confusion

Recommended

Servers and agents: use the curl installer. Local macOS: Homebrew when available, otherwise npm or curl. Rust shops: Cargo builds on your host glibc.

curl (standalone)

macOS / Linuxtypescript
curl -fsSL https://sylphx.com/install/cli | bash

# ensure ~/.local/bin is on PATH
export PATH="$HOME/.local/bin:$PATH"
sylphx --version
sylphx doctor

Optional: SYLPHX_CLI_VERSION=0.2.6 pins a product version; SYLPHX_CLI_PREFIX sets the install prefix (default $HOME/.local).

npm / pnpm / bun

typescript
npm install -g @sylphx/cli
sylphx --version

The npm package is a distribution adapter. Product version is reported by sylphx --version (Rust crate), not only the npm package number.

Cargo

typescript
cargo install sylphx-cli --locked
sylphx --version

Cargo builds against the host glibc, which is the fallback when a prebuilt binary does not run on an older distribution.

Homebrew

typescript
brew install sylphxai/tap/sylphx
sylphx --version

Tap

Use the official Sylphx tap formula when published. Upgrade only with brew upgrade — do not overwrite Brew-managed files with a foreign binary.

What we do not ship as CLI channels

  • WASM operator CLI — out of scope. Native binary only.
  • Private GitHub asset URLs as the default customer download — public install uses the npm binary packages / install script.
  • apt / Scoop / winget — deferred; may only repackage the same binary later.

Next

bash
sylphx --version   # product version, from the Rust binary
sylphx doctor      # install, auth and config health
A channel that installed the binary does not change what it does.

Verify

sylphx --version should print the product version after any channel; if sylphx is not found, the install prefix is not on PATH.

Related

Was this page helpful?

Tell us what is missing, wrong, or unclear — this opens a real inbox.

Send feedback

Platform links