From 6663a2d5c8bba0ea36b4c72f1a01bdd414cb34cf Mon Sep 17 00:00:00 2001
From: yoma <yingwaizhiying@gmail.com>
Date: Sun, 5 Jul 2026 16:06:25 +0800
Subject: [PATCH] docs(cli): document publish command

---
 packages/cli/README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/cli/README.md b/packages/cli/README.md
index fffe6cc26e..c4c812d97b 100644
--- a/packages/cli/README.md
+++ b/packages/cli/README.md
@@ -49,6 +49,22 @@ npx hyperframes render -o output.mp4
 npx hyperframes render -c ./my-composition.html -o output.mp4
 ```
 
+### `publish`
+
+Upload a project and create a stable public URL:
+
+```bash
+npx hyperframes publish
+npx hyperframes publish ./my-video
+npx hyperframes publish --public
+npx hyperframes publish --update <url-or-id>
+npx hyperframes publish --space <space-id>
+npx hyperframes publish --yes
+```
+
+Use `--public` to make a claimed project available to anyone, rather than only
+to the user who claimed it.
+
 ### `lint`
 
 Validate your Hyperframes HTML: