From 3c99ddb04167c5b9a1c007f41b129483e1d35689 Mon Sep 17 00:00:00 2001
From: WilliamK112 <164879897+WilliamK112@users.noreply.github.com>
Date: Sat, 11 Apr 2026 21:41:26 -0500
Subject: [PATCH] docs(reference): align onboard usage with supported flags

---
 .../references/commands.md                    | 19 ++++++++++++++++++-
 docs/reference/commands.md                    | 19 ++++++++++++++++++-
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/.agents/skills/nemoclaw-user-reference/references/commands.md b/.agents/skills/nemoclaw-user-reference/references/commands.md
index 0e7faabd3df..512effbdd0d 100644
--- a/.agents/skills/nemoclaw-user-reference/references/commands.md
+++ b/.agents/skills/nemoclaw-user-reference/references/commands.md
@@ -44,7 +44,7 @@ The wizard creates an OpenShell gateway, registers inference providers, builds t
 Use this command for new installs and for recreating a sandbox after changes to policy or configuration.
 
 ```console
-$ nemoclaw onboard [--non-interactive] [--resume] [--from <Dockerfile>]
+$ nemoclaw onboard [--non-interactive] [--resume] [--recreate-sandbox] [--from <Dockerfile>] [--agent <name>] [--yes-i-accept-third-party-software]
 ```
 
 > **Warning:** For NemoClaw-managed environments, use `nemoclaw onboard` when you need to create or recreate the OpenShell gateway or sandbox.
@@ -72,6 +72,23 @@ or:
 $ NEMOCLAW_ACCEPT_THIRD_PARTY_SOFTWARE=1 nemoclaw onboard --non-interactive
 ```
 
+#### `--recreate-sandbox`
+
+Delete and recreate the existing sandbox instead of reusing it.
+Use this when you need onboarding to rebuild the sandbox after configuration changes or to recover from a broken sandbox state.
+
+```console
+$ nemoclaw onboard --resume --recreate-sandbox
+```
+
+#### `--agent <name>`
+
+Select a specific packaged agent during onboarding instead of using the default agent.
+
+```console
+$ nemoclaw onboard --agent hermes
+```
+
 To enable Brave Search in non-interactive mode, set:
 
 ```console
diff --git a/docs/reference/commands.md b/docs/reference/commands.md
index 44960dfc6d8..4f94f1e0e7f 100644
--- a/docs/reference/commands.md
+++ b/docs/reference/commands.md
@@ -64,7 +64,7 @@ The wizard creates an OpenShell gateway, registers inference providers, builds t
 Use this command for new installs and for recreating a sandbox after changes to policy or configuration.
 
 ```console
-$ nemoclaw onboard [--non-interactive] [--resume] [--from <Dockerfile>]
+$ nemoclaw onboard [--non-interactive] [--resume] [--recreate-sandbox] [--from <Dockerfile>] [--agent <name>] [--yes-i-accept-third-party-software]
 ```
 
 :::{warning}
@@ -94,6 +94,23 @@ or:
 $ NEMOCLAW_ACCEPT_THIRD_PARTY_SOFTWARE=1 nemoclaw onboard --non-interactive
 ```
 
+#### `--recreate-sandbox`
+
+Delete and recreate the existing sandbox instead of reusing it.
+Use this when you need onboarding to rebuild the sandbox after configuration changes or to recover from a broken sandbox state.
+
+```console
+$ nemoclaw onboard --resume --recreate-sandbox
+```
+
+#### `--agent <name>`
+
+Select a specific packaged agent during onboarding instead of using the default agent.
+
+```console
+$ nemoclaw onboard --agent hermes
+```
+
 To enable Brave Search in non-interactive mode, set:
 
 ```console