CLI Chats
Last updated
Start and continue chats with Ploy's Agent from the terminal.
Use ploy chat to give Ploy's Agent work from a script, a coding agent, or CI, and read its answers.
Start and continue a chat
ploy chat start "Add a pricing page with three tiers" --site <site-id> --wait
ploy chat send <chat-id> "Make the middle tier stand out" --wait| Option | What it does |
|---|---|
--site <site-id> | Attach the chat to a site (start only). |
--title <title> | Name the chat (start only). Defaults to the opening message. |
--agent ploy|lite | Choose Ploy Agent or Ploy Lite (start only). |
--file-id <ids...> | Attach files uploaded with ploy chat upload. |
--wait | Wait for the agent's response and print it. |
--timeout <seconds> | Maximum wait, 1 to 3600 seconds, default 300. A timeout exits 5 and the chat keeps running. |
--json | Print structured JSON. |
Pass - as the message to read it from standard input. ploy chat send --steer <turn-id> tries to redirect the turn that is running.
Read and wait
ploy chat listlists your chats.ploy chat read <chat-id>prints the conversation.ploy chat wait <chat-id>reconnects and prints output until the pending work settles. A timeout exits 5; the chat keeps running.ploy chat get <chat-id>shows the chat and its dashboard link.
Answer questions and approvals
ploy chat questions <chat-id>lists questions waiting for you.ploy chat answer <chat-id> [answer]answers one. Use--choice <numbers>for numbered options,--decisionfor approvals, or--boolean yes|nofor yes/no questions.
Manage chats and files
ploy chat stop <chat-id>stops the agent's current work. Background jobs keep running, and the agent can continue when one finishes.ploy chat rename <chat-id>,ploy chat delete <chat-id>(stop active work first), andploy chat mark-read <chat-id>.ploy chat upload <path>uploads a private file of up to 10 MB and prints a File ID to pass with--file-id.