Skip to main content

Update the CLI

1 min

Industry standard: update the way you installed. Explicit only — never silent.

No silent auto-update

The CLI never upgrades itself in the background. Agents and CI stay deterministic until you run an explicit update command.

Rule

Update using the same channel you used to install. That is how Codex, Homebrew, and most Linux tools expect package ownership to work.

By install channel

PropertyTypeDescription
curl / standalonecommandsylphx update # or re-run install-sylphx.sh
npmcommandnpm install -g @sylphx/cli@latest
pnpmcommandpnpm add -g @sylphx/cli@latest
buncommandbun add -g @sylphx/cli@latest
Cargocommandcargo install sylphx-cli --locked --force
Homebrewcommandbrew upgrade sylphx

sylphx update

sylphx update is the explicit entrypoint for upgrades. On a standalone install it refreshes the binary. On package-manager installs it should follow that manager (or tell you the exact command) — it must not silently overwrite a brew/npm/cargo install without an explicit force flag.

# Check only (no install)
sylphx update --check

# Upgrade (standalone installs)
sylphx update

# Machine-readable
sylphx update --check --json

Happy path is short

When you are already current you should see a single confirmation such as sylphx 0.2.6 is current. Details (package URLs, internal labels) belong on --check / --json, not the default success path.

If a prebuilt binary will not run

On older glibc hosts, prefer a host build:

cargo install sylphx-cli --locked --force