docs(reference): document onboard recreate-sandbox and agent flags

[WilliamK112]

Summary

• add dedicated reference entries for --recreate-sandbox and --agent <name> under nemoclaw onboard
• keep the change scoped to the remaining flag documentation that was left out after docs(commands): align onboard usage synopsis with CLI output #1783 merged
• regenerate the derived user-reference skill content from docs/

Testing

• npm test -- test/check-docs-links.test.ts

Related

• follow-up to docs(reference): align onboard usage with supported flags #1795
• relates to [All Platforms] CLI reference docs/reference/commands.md omits --recreate-sandbox, --agent, and --yes-i-accept-third-party-software from nemoclaw onboard usage #1730

Summary by CodeRabbit

• Documentation
  • Added comprehensive documentation for the --recreate-sandbox option, which forces deletion and recreation of the existing sandbox environment during onboarding.
  • Added documentation for the --agent <name> option, allowing users to select a specific installed agent profile during onboarding.
  • Documented the NEMOCLAW_RECREATE_SANDBOX=1 environment variable as an equivalent approach for non-interactive onboarding runs.

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 37bb03c6-f5de-4dd8-b10a-20203190da2f

📥 Commits

Reviewing files that changed from the base of the PR and between 9c5a42a and 0f64b53.

📒 Files selected for processing (2)

• .agents/skills/nemoclaw-user-reference/references/commands.md
• docs/reference/commands.md

---

📝 Walkthrough

Walkthrough

Documentation updates to the nemoclaw onboard command reference files, adding descriptions for two new CLI options: --recreate-sandbox (for forcing sandbox deletion and recreation) and --agent <name> (for selecting a specific installed agent profile during onboarding).

Changes

Cohort / File(s)	Summary
Command Reference Documentation .agents/skills/nemoclaw-user-reference/references/commands.md, docs/reference/commands.md	Added documentation for two new nemoclaw onboard CLI options: --recreate-sandbox (with example and non-interactive environment variable alternative NEMOCLAW_RECREATE_SANDBOX=1) and --agent <name> (for selecting an installed agent profile). Both additions include usage examples.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Our docs now bloom with flags so new,
--recreate-sandbox and agents too!
A rabbit's joy when references grow clear,
The onboard command gets upgrades here! 📚✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the main change: documenting two new onboard command flags (recreate-sandbox and agent), matching the actual scope of the PR.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[wscurran]

✨ Thanks for submitting this pull request that proposes a way to document the onboard recreate-sandbox and agent flags. This identifies a documentation gap and proposes a change to include dedicated reference entries for these flags under nemoclaw onboard, enhancing clarity and usability.

---

Related open PRs:

• #1795 docs(reference): align onboard usage with supported flags
• #1783 docs(commands): align onboard usage synopsis with CLI output

---

Related open issues:

• #1730 [All Platforms] CLI reference docs/reference/commands.md omits --recreate-sandbox, --agent, and --yes-i-accept-third-party-software from nemoclaw onboard usage

[wscurran]

✨ Thanks for submitting this pull request that proposes a way to document the onboard recreate-sandbox and agent flags. This identifies a documentation gap and proposes a change to include dedicated reference entries for these flags.

---

Related open PRs:

• #1795 docs(reference): align onboard usage with supported flags
• #1783 docs(commands): align onboard usage synopsis with CLI output

---

Related open issues:

• #1730 [All Platforms] CLI reference docs/reference/commands.md omits --recreate-sandbox, --agent, and --yes-i-accept-third-party-software from nemoclaw onboard usage