Ploy CLI

A reliable command surface for people, automations, and AI agents.

The Ploy CLI is a standalone command-line interface for managing workspaces, sites, content, and publishing workflows. Use it interactively, from repeatable automations, or as a structured way for agents to operate Ploy.

The installed ploy binary does not require Bun, Node.js, or npm. The installer supports macOS and Linux on arm64 and x64.

Quick start

Install the CLI, sign in through the Ploy web app, then choose the workspace and site you want to work with.

curl -fsSL https://ploy.ai/install.sh | sh
ploy login
ploy workspace use
ploy site use
ploy site status

Interactive selectors require a terminal. For scripts and CI, pass explicit IDs with --workspace, workspace use --id, and site use --id.

Get started

Choose the workflow that matches what you want to do next:

Manage a site: create, inspect, and publish sites with Workspaces, sites, and Code Sync.
Create an automation: manage reusable content and workflows with Documents and Ploybooks.
Local development: connect your site with Code Sync, install Ploy skills, and give your coding agent design-system context with the local development guide.

What you can do

Workflow	Start here
Install, update, and configure	Installation and updates
Sign in and manage credentials	Authentication and tokens
Create, inspect, and publish sites	Workspaces, sites, and Code Sync
Manage runtime configuration	Variables, Secrets, and dotenv imports
Work with content and automations	Documents and Ploybooks
Develop locally with your agent	Code Sync, skills, and design-system inspection
Use the CLI from agents and automations	Global contract and command index

Command help

The built-in help stays aligned with the installed version:

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