docs: sync oclif UX command reference

[cv]

Summary

Sync the CLI command reference with the oclif UX changes in the stacked parser/help PRs. This updates documented usage for new aliases, parser-owned flags, and recent command examples.

Stack Navigation

• Position: 22 of 60
• Previous PR: #2913 — refactor(cli): model onboard flags with oclif
• Next PR: #2916 — refactor(cli): extract public argv normalizer

Changes

• Documented --resume | --fresh in onboard usage.
• Added logs --tail/-n and --since usage.
• Updated lifecycle confirmation aliases and debug short flags.
• Updated gc and upgrade-sandboxes confirmation alias references.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• No secrets, API keys, or credentials committed
• Docs updated for user-facing behavior changes
• make docs builds without warnings (doc changes only)
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Carlos Villela cvillela@nvidia.com

Summary by CodeRabbit

• Documentation
  • Updated CLI command references for nemoclaw with new flag aliases
  • Added --fresh option for nemoclaw onboard command
  • Added -y and -v short flags for nemoclaw rebuild command
  • Added -q and -o short flags for nemoclaw debug command
  • Documented flag shortcuts for nemoclaw destroy command

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: c2ac4f9b-fc73-497d-b53e-258e0190c7c8

📥 Commits

Reviewing files that changed from the base of the PR and between 702afb1 and 0df2084.

📒 Files selected for processing (1)

• docs/reference/commands.md

---

📝 Walkthrough

Walkthrough

Updated documentation for nemoclaw CLI commands to include additional flag aliases (-y, -v, -q, -o) and document --fresh as an alternative to --resume in the onboard command.

Changes

CLI Command Reference Updates

Layer / File(s)	Summary
Documentation docs/reference/commands.md	Four command sections updated: nemoclaw onboard adds --fresh; nemoclaw destroy documents -y alias for --yes; nemoclaw rebuild adds -y and -v aliases with updated synopsis and flag tables; nemoclaw debug adds -q and -o aliases with updated synopsis and flag table.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hop, skip, and flags galore!
Short names make CLI less of a chore,
-y, -v, -q, -o shine bright,
The docs now reflect what works just right! 🎉

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/oclif-ux-command-reference-sync

---

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

[cjagwani]

Approved as part of the oclif refactor stack — initial smoke flag was a CANCELLED commit-lint that's since been superseded by SUCCESS. CI green.