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, then ploy login for interactive use or set PLOY_API_TOKEN for CI and other headless environments.

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.
Work with structured data: list databases and tables, query records, and import CSV files with the database commands.
Local development: connect your site with Code Sync, install Ploy skills, and give your coding agent design-system context with the local development guide.
Remote agents and CI: authenticate without a browser and run non-interactive workflows with the remote environments 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
Inspect and import structured data	Databases, tables, queries, and CSV imports
Work with content and automations	Documents and Ploybooks
Develop locally with your agent	Code Sync, skills, and design-system inspection
Run Ploy remotely	Remote agents and CI
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