From ee37be16f08679fa194052a048d8b87a8e764d23 Mon Sep 17 00:00:00 2001
From: Reynaldi Chernando <12949382+reynaldichernando@users.noreply.github.com>
Date: Wed, 10 Jun 2026 00:40:19 +0700
Subject: [PATCH] Add cli deployment docs (#3239)

---
 src/docs/src/Workers.md     | 20 ++++++++++++++++++++
 src/docs/src/deployments.md | 20 ++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/src/docs/src/Workers.md b/src/docs/src/Workers.md
index bef515eba..5917c5e17 100644
--- a/src/docs/src/Workers.md
+++ b/src/docs/src/Workers.md
@@ -173,6 +173,26 @@ The quickest way to publish a worker is to create it on [puter.com](https://pute
     </li>
 </ol>
 
+### Deploy with the Puter CLI
+
+You can also deploy straight from the terminal with the [Puter CLI](https://www.npmjs.com/package/@heyputer/cli).
+
+Install it globally:
+
+```
+npm install -g @heyputer/cli
+```
+
+Then deploy your worker's JavaScript file to a `*.puter.work` subdomain:
+
+```
+puter worker deploy [file] [name]
+```
+
+Both arguments are optional — run `puter worker deploy` with no arguments and the CLI prompts you for the file and worker name.
+
+<div class="info">The Puter CLI is currently in beta (0.x), so commands and behavior may change.</div>
+
 ### Automate with GitHub Actions
 
 If your worker's code lives on GitHub, you can redeploy it automatically on every push using the [Puter Worker Deploy Action](https://github.com/HeyPuter/puter-worker-deploy-action).
diff --git a/src/docs/src/deployments.md b/src/docs/src/deployments.md
index cd65ae5b8..2c913ae94 100644
--- a/src/docs/src/deployments.md
+++ b/src/docs/src/deployments.md
@@ -50,6 +50,26 @@ The quickest way to publish a website is to upload it on [puter.com](https://put
     </li>
 </ol>
 
+### Deploy with the Puter CLI
+
+You can also deploy straight from the terminal with the [Puter CLI](https://www.npmjs.com/package/@heyputer/cli).
+
+Install it globally:
+
+```
+npm install -g @heyputer/cli
+```
+
+Then deploy your site's directory to a `*.puter.site` subdomain:
+
+```
+puter site deploy [dir] [subdomain]
+```
+
+Both arguments are optional — run `puter site deploy` with no arguments and the CLI prompts you for the directory and subdomain.
+
+<div class="info">The Puter CLI is currently in beta (0.x), so commands and behavior may change.</div>
+
 ### Automate with GitHub Actions
 
 If your code lives on GitHub, you can redeploy your site automatically on every push using the [Puter Subdomain Deploy Action](https://github.com/HeyPuter/puter-subdomain-deploy-action).