@sylphx/cli

@sylphx/cli

npm install channel for the Rust operator CLI (sylphx).

This package does not reimplement the CLI in TypeScript. It installs and executes the same native binary published as sylphx-cli on crates.io (ADR-3820 sole-wire dual-language product path).

Channel	Command	Product
npm	npm install -g @sylphx/cli	Rust sylphx binary
crates.io	cargo install sylphx-cli	same Rust sylphx binary

Install

npm install -g @sylphx/cli
# equivalent:
cargo install sylphx-cli

Ships a vendored native binary under binaries/<os>-<arch>/ for supported hosts (linux-x64 first). Optional platform packages (@sylphx/cli-linux-x64, @sylphx/cli-darwin-arm64, …). If the optional native package is missing for your OS/arch, install falls back messaging to cargo install sylphx-cli.

Override path (advanced):

export SYLPHX_CLI_BINARY=/path/to/sylphx

Agent operator commands (Rust binary)

Full agent-operable surface (no Console). See sylphx version-info --json for the authoritative shippedCommands list including:

deploy, rollback, status, env list|set|rm, logs, resources, db, storage, tasks, backup, flags, previews cost, projects create, plus day-1 health/whoami/…

export SYLPHX_TOKEN=svc_...
export SYLPHX_API_URL=https://api.sylphx.com/v1   # optional
sylphx health --json
sylphx projects list --json
sylphx environments list prj_demo --json

Versioning

• npm package @sylphx/cli version (this package) follows the npm channel.
• Binary --version reports the Rust crate sylphx-cli version (see package.json#sylphx.crateVersion).

Wire SSOT: Protobuf under api/proto (sylphx.platform.v1). App library: @sylphx/sdk (TypeScript) / sylphx-sdk (Rust).

Supported install platforms

• Published optional native packages: linux-x64, linux-arm64, darwin-x64, darwin-arm64
• Windows: not yet on the npm optional channel; use GitHub Releases when a Windows asset is published, or cargo install sylphx-cli