diff --git a/README.md b/README.md
index 0ec5b1aee..342fd2cf6 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,9 @@ pnpm clawdis login
 # Start the gateway
 pnpm clawdis gateway --port 18789 --verbose
 
+# Dev loop (auto-reload on TS changes)
+pnpm gateway:watch
+
 # Send a message
 pnpm clawdis send --to +1234567890 --message "Hello from Clawdis"
 
diff --git a/docs/gateway.md b/docs/gateway.md
index 86aa497f4..88fac52aa 100644
--- a/docs/gateway.md
+++ b/docs/gateway.md
@@ -19,6 +19,8 @@ pnpm clawdis gateway --port 18789
 pnpm clawdis gateway --port 18789 --verbose
 # if the port is busy, terminate listeners then start:
 pnpm clawdis gateway --force
+# dev loop (auto-reload on TS changes):
+pnpm gateway:watch
 ```
 - Binds WebSocket control plane to `127.0.0.1:<port>` (default 18789).
 - Starts a Canvas file server by default on `canvasHost.port` (default `18793`), serving `http://<gateway-host>:18793/__clawdis__/canvas/` from `~/clawd/canvas`. Disable with `canvasHost.enabled=false` or `CLAWDIS_SKIP_CANVAS_HOST=1`.
diff --git a/package.json b/package.json
index 3ad0f7cb5..529fc419e 100644
--- a/package.json
+++ b/package.json
@@ -42,6 +42,7 @@
     "ui:build": "pnpm -C ui build",
     "start": "tsx src/index.ts",
     "clawdis": "tsx src/index.ts",
+    "gateway:watch": "tsx watch --clear-screen=false --include 'src/**/*.ts' src/index.ts gateway --force",
     "clawdis:rpc": "tsx src/index.ts agent --mode rpc --json",
     "lint": "biome check src test && oxlint --type-aware src test --ignore-pattern src/canvas-host/a2ui/a2ui.bundle.js",
     "lint:swift": "swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)",