From 1a2d39bdf954268978eb7195734d7dfef2b9261a Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 18 Dec 2025 00:37:40 +0000
Subject: [PATCH] Docs: document nodes status

---
 README.md               | 4 ++--
 docs/android/connect.md | 4 ++--
 docs/gateway/pairing.md | 1 +
 docs/ios/connect.md     | 4 ++--
 4 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 559899f22..98546183a 100644
--- a/README.md
+++ b/README.md
@@ -124,7 +124,7 @@ Iris is an internal/prototype iOS app that connects as a **remote node**:
 
 - **Voice trigger:** forwards transcripts into the Gateway (agent runs + wakeups).
 - **Canvas screen:** a WKWebView + `<canvas>` surface the agent can control (via `screen.eval` / `screen.snapshot` over `node.invoke`).
-- **Discovery + pairing:** finds the bridge via Bonjour (`_clawdis-bridge._tcp`) and uses Gateway-owned pairing (`clawdis nodes pending|approve`).
+- **Discovery + pairing:** finds the bridge via Bonjour (`_clawdis-bridge._tcp`) and uses Gateway-owned pairing (`clawdis nodes pending|approve`); `clawdis nodes status` shows paired nodes + capabilities.
 
 Runbook: `docs/ios/connect.md`
 
@@ -201,7 +201,7 @@ Bot-mode support (grammY only) shares the same `main` session as WhatsApp/WebCha
 | `clawdis gateway health|status|send|agent|call` | Gateway WS clients; assume a running gateway. |
 | `clawdis wake` | Enqueue a system event and optionally trigger a heartbeat via the Gateway. |
 | `clawdis cron ...` | Manage scheduled jobs (via Gateway). |
-| `clawdis nodes ...` | Manage Gateway-owned node pairing. |
+| `clawdis nodes ...` | Manage nodes (pairing + status) via the Gateway. |
 | `clawdis status` | Web session health + session store summary |
 | `clawdis health` | Reports cached provider state from the running gateway. |
 | `clawdis webchat` | Start the loopback-only WebChat HTTP server |
diff --git a/docs/android/connect.md b/docs/android/connect.md
index 8d10d70d5..fde107f4a 100644
--- a/docs/android/connect.md
+++ b/docs/android/connect.md
@@ -82,9 +82,9 @@ Pairing details: `docs/gateway/pairing.md`.
 
 ## 5) Verify the node is connected
 
-- Via nodes list:
+- Via nodes status:
   ```bash
-  clawdis nodes list
+  clawdis nodes status
   ```
 - Via Gateway:
   ```bash
diff --git a/docs/gateway/pairing.md b/docs/gateway/pairing.md
index 24f7961e1..f5c685fc5 100644
--- a/docs/gateway/pairing.md
+++ b/docs/gateway/pairing.md
@@ -70,6 +70,7 @@ CLI must be able to fully operate without any GUI:
 - `clawdis nodes pending`
 - `clawdis nodes approve <requestId>`
 - `clawdis nodes reject <requestId>`
+- `clawdis nodes status` (paired nodes + connection status/capabilities)
 
 Optional interactive helper:
 - `clawdis nodes watch` (subscribe to `node.pair.requested` and prompt in-place)
diff --git a/docs/ios/connect.md b/docs/ios/connect.md
index c9312b388..575e162fd 100644
--- a/docs/ios/connect.md
+++ b/docs/ios/connect.md
@@ -101,9 +101,9 @@ Pairing details: `docs/gateway/pairing.md`.
 ## 5) Verify the node is connected
 
 - In the macOS app: **Instances** tab should show something like `iOS Node (...)`.
-- Via nodes list (paired + connected):
+- Via nodes status (paired + connected):
   ```bash
-  clawdis nodes list
+  clawdis nodes status
   ```
 - Via Gateway (paired + connected):
   ```bash