Description
Description
docs/reference/commands.md is missing documentation for three user-visible flags exposed by the CLI:
1. `nemoclaw onboard --fresh` — appears in synopsis but has no explanation
2. `nemoclaw onboard --yes / -y` — missing from the commands.md synopsis entirely
3. `nemoclaw connect --probe-only` — completely undocumented (zero hits in docs)
All three are public, non-hidden flags in the source. Users reading commands.md cannot tell what `--fresh` does or that `--probe-only` exists.
Environment
Device: N/A (docs-site issue, observed in browser and source repo)
OS: All client platforms (HTML content is identical across OS)
Architecture: N/A
Node.js: N/A
npm: N/A
Docker: N/A
OpenShell CLI: N/A
NemoClaw: 0.0.37 (preferred version on docs.nvidia.com/nemoclaw/)
OpenClaw: N/A
Steps to Reproduce
1. Open https://docs.nvidia.com/nemoclaw/latest/reference/commands.html (or docs/reference/commands.md in main).
2. Search the page for `--fresh` — find one synopsis mention with no explanation block.
3. Search the page for `--probe-only` — find zero hits.
4. Search the synopsis for `--yes` or `-y` — find that the onboard synopsis only lists `--yes-i-accept-third-party-software`, not `--yes / -y`.
5. Run `nemoclaw onboard --help` and observe `--fresh`, `--yes | -y` documented in the FLAGS list.
6. Run `nemoclaw my-assistant connect --help` and observe `--probe-only` documented with description "Recover and check the sandbox without opening SSH".
Expected Result
- commands.md `### nemoclaw onboard` section explains `--fresh` semantics and contrasts with `--resume` (one ignores any saved session, the other resumes an interrupted session).
- commands.md onboard synopsis includes `[--yes | -y]`, with at least a one-line explanation that it skips confirmation prompts.
- commands.md `### nemoclaw connect` section documents `--probe-only` with the same wording the source already uses ("Recover and check the sandbox without opening SSH"), matching the existing pattern for `--from`, `--name`, and the GPU passthrough section.
Actual Result
grep -E "--fresh" docs/reference/commands.md → 1 hit (synopsis only)
grep -E "--yes\b" docs/reference/commands.md → 0 hits in onboard synopsis
grep -E "--probe-only" docs/reference/commands.md → 0 hits anywhere
Source confirming the flags are public:
- src/lib/commands/onboard.ts (--fresh, --yes both visible in --help output)
- src/lib/commands/sandbox/connect.ts:24 — `"probe-only": Flags.boolean({ description: "Recover and check the sandbox without opening SSH" })`
- The connect command also has a working example: `nemoclaw sandbox connect alpha --probe-only`
- Neither has `static
Logs
Not applicable (docs content review).
Bug Details
| Field |
Value |
| Priority |
Unprioritized |
| Action |
Dev - Open - To fix |
| Disposition |
Open issue |
| Module |
Machine Learning - NemoClaw |
| Keyword |
NemoClaw, NemoClaw_Docs, NEMOCLAW_GH_SYNC_APPROVAL, NemoClaw-SWQA-VDR |
[NVB#6157307]
Description
Description
Environment Steps to Reproduce Expected Result- commands.md `### nemoclaw onboard` section explains `--fresh` semantics and contrasts with `--resume` (one ignores any saved session, the other resumes an interrupted session). - commands.md onboard synopsis includes `[--yes | -y]`, with at least a one-line explanation that it skips confirmation prompts. - commands.md `### nemoclaw connect` section documents `--probe-only` with the same wording the source already uses ("Recover and check the sandbox without opening SSH"), matching the existing pattern for `--from`, `--name`, and the GPU passthrough section.Actual Resultgrep -E "--fresh" docs/reference/commands.md → 1 hit (synopsis only) grep -E "--yes\b" docs/reference/commands.md → 0 hits in onboard synopsis grep -E "--probe-only" docs/reference/commands.md → 0 hits anywhere Source confirming the flags are public: - src/lib/commands/onboard.ts (--fresh, --yes both visible in --help output) - src/lib/commands/sandbox/connect.ts:24 — `"probe-only": Flags.boolean({ description: "Recover and check the sandbox without opening SSH" })` - The connect command also has a working example: `nemoclaw sandbox connect alpha --probe-only` - Neither has `staticLogsBug Details
[NVB#6157307]