Install and update the Ploy CLI

One standalone binary. No package manager or JavaScript runtime required.

Install

curl -fsSL https://ploy.ai/install.sh | sh
ploy login

The installer puts ploy in $HOME/.local/bin by default. If that directory is not already on PATH, the installer adds it to your shell profile.

The installed binary does not require Bun, Node.js, or npm. Those tools are only needed by specific local inspection commands when noted.

Check your installation

ploy --version
ploy help
ploy help site
ploy site publish --help

Use the built-in help when you need syntax that matches the exact CLI version installed on your machine.

Update

ploy update

ploy update downloads the newest released binary and atomically replaces the current executable. If the install directory is not writable, the CLI prints a manual installation command instead of partially updating itself.

The CLI performs a best-effort update check at most once per day. Disable the notice when you manage versions another way:

PLOY_NO_UPDATE_CHECK=1 ploy --version

Installer analytics

The installer sends one anonymous event after a successful installation. Either environment variable disables that event:

DO_NOT_TRACK=1 curl -fsSL https://ploy.ai/install.sh | sh
PLOY_INSTALL_NO_ANALYTICS=1 curl -fsSL https://ploy.ai/install.sh | sh

Keep going

• Check the complete CLI contract for global options, environment variables, saved state, and exit codes.
• Manage workspaces and sites, including site creation, status, publishing, and Code Sync.
• Equip agents with Ploy skills and inspect a site's design-system context.