Skip to content

[All Platforms][Docs] commands.md missing documentation for nemoclaw onboard --fresh, --yes, and <name> connect --probe-only #3233

@hulynn

Description

@hulynn

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]

Metadata

Metadata

Assignees

No one assigned

    Labels

    NV QABugs found by the NVIDIA QA Teamarea: docsDocumentation, examples, guides, or docs build

    Type

    No fields configured for Bug.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions