From d7440baef614be63cac428b5eab7d33ba7aeba0d Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Wed, 21 Jan 2026 03:49:13 +0000
Subject: [PATCH] docs: clarify update help

---
 src/cli/update-cli.ts | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/cli/update-cli.ts b/src/cli/update-cli.ts
index 50e68bef6..99c7c525b 100644
--- a/src/cli/update-cli.ts
+++ b/src/cli/update-cli.ts
@@ -679,6 +679,15 @@ What this does:
   - Git checkouts: fetches, rebases, installs deps, builds, and runs doctor
   - npm installs: updates via detected package manager
 
+Switch channels:
+  - Use --channel stable|beta|dev to persist the update channel in config
+  - Run clawdbot update status to see the active channel and source
+  - Use --tag <dist-tag|version> for a one-off npm update without persisting
+
+Non-interactive:
+  - Use --yes to accept downgrade prompts
+  - Combine with --channel/--tag/--restart/--json/--timeout as needed
+
 Examples:
   clawdbot update                   # Update a source checkout (git)
   clawdbot update --channel beta    # Switch to beta channel (git + npm)