Skip to content

docs(uninstall): show flag-passing form for the hosted uninstall.sh (#2357)#3124

Merged
ericksoa merged 5 commits into
NVIDIA:mainfrom
latenighthackathon:docs/uninstall-flag-passing
May 20, 2026
Merged

docs(uninstall): show flag-passing form for the hosted uninstall.sh (#2357)#3124
ericksoa merged 5 commits into
NVIDIA:mainfrom
latenighthackathon:docs/uninstall-flag-passing

Conversation

@latenighthackathon
Copy link
Copy Markdown
Contributor

@latenighthackathon latenighthackathon commented May 6, 2026

Summary

#2357 reports that the docs show curl ... | bash for the hosted uninstall.sh but do not show how to pass --yes, --keep-openshell, or --delete-models through the pipe. Trying the obvious curl ... | bash --yes errors out because flags before the pipeline target hit bash itself, not the script.

Problem

The flags table on docs/manage-sandboxes/lifecycle.md already lists the three uninstall flags for nemoclaw uninstall. The hosted uninstall.sh accepts the same flags, but the curl|bash example below the table did not show the bash -s -- form, leaving users to guess.

Changes

  • Add a one-line example demonstrating the bash -s -- <flags> form right after the existing curl|bash example. The example uses --yes --delete-models to show two flags compose.
  • Mirror the same addition into .agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md so the skill stays aligned with the source.

Type of Change

  • Doc only (prose changes, no code sample modifications)

Test plan

  • No code change; no behavioral test added.
  • Doc claims (the three flag names, the bash -s -- shell idiom) match uninstall.sh:129-138.
  • Skill mirror addition is identical to the source addition.

Closes #2357


Signed-off-by: latenighthackathon latenighthackathon@users.noreply.github.com

Summary by CodeRabbit

  • Documentation
    • Clarified the Uninstall step to note that the flags (--yes, --keep-openshell, --delete-models) are honored when using the hosted uninstall script as well as local invocations.
    • Added a curl | bash -s -- example demonstrating how to invoke the hosted uninstall script and forward those flags so behavior is consistent and clear for end users.

Review Change Stack

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 6, 2026

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
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 6, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This PR clarifies uninstall flag usage for NemoClaw sandbox management. It updates two documentation files to state that --yes, --keep-openshell, and --delete-models also apply to the hosted uninstall script and adds a curl | bash -s -- example showing how to pass those flags.

Changes

Uninstall Flag Documentation

Layer / File(s) Summary
Public documentation update
docs/manage-sandboxes/lifecycle.md
Uninstall section gains explanatory text and a curl + bash -s -- code block demonstrating passing --yes, --keep-openshell, and --delete-models to the hosted script.
Skill Definition Update
.agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md
Step 9 updated to note the same uninstall flags apply to the hosted uninstall script and adds an example using bash -s --.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Flags whisper down the command line,

curl meets bash and answers sign,
Pass the dashes, watch them run,
Sandboxes fold when the job is done.

🚥 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 accurately describes the main change: demonstrating how to pass flags to the hosted uninstall.sh script using the bash -s -- idiom.
Linked Issues check ✅ Passed The pull request directly addresses issue #2357 by adding documentation examples showing how to pass flags (--yes, --keep-openshell, --delete-models) to the hosted uninstall.sh using the curl | bash -s -- form.
Out of Scope Changes check ✅ Passed All changes are within scope: documentation updates to the uninstall section in two files (main docs and skill file) directly related to the flag-passing requirement from issue #2357.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ 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.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/manage-sandboxes/lifecycle.md`:
- Around line 276-278: Change the code fence for the CLI example that currently
uses ```bash``` to use ```console``` and prefix the command line with the shell
prompt `$`; locate the block containing the uninstall curl pipeline (the snippet
with `curl -fsSL
https://raw.githubusercontent.com/NVIDIA/NemoClaw/refs/heads/main/uninstall.sh |
bash -s -- --yes --delete-models`) and replace the fence language and add the
leading `$ ` before the command so the example follows the required console/$
formatting.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: a1f69aa6-6fcf-450a-84ff-2253b187a9be

📥 Commits

Reviewing files that changed from the base of the PR and between f5b8144 and 141e926.

📒 Files selected for processing (2)
  • .agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md
  • docs/manage-sandboxes/lifecycle.md

Comment thread docs/manage-sandboxes/lifecycle.md
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
docs/manage-sandboxes/lifecycle.md (1)

274-274: ⚡ Quick win

End the sentence with a period instead of a colon.

Line 274 currently ends with :. Please end the sentence with . to match docs source formatting rules.

Suggested edit
-The same `--yes`, `--keep-openshell`, and `--delete-models` flags listed above also apply to the hosted script. Pass them after `bash -s --`:
+The same `--yes`, `--keep-openshell`, and `--delete-models` flags listed above also apply to the hosted script. Pass them after `bash -s --`.

As per coding guidelines, “Every sentence must end with a period.” and “Colons should only introduce a list.”

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/manage-sandboxes/lifecycle.md` at line 274, The sentence describing how
to pass flags to the hosted script currently ends with a colon; change the
trailing punctuation to a period so the sentence reads "...Pass them after `bash
-s --`." Update the line containing the flags `--yes`, `--keep-openshell`, and
`--delete-models` and the text `bash -s --` to end with a period instead of a
colon to comply with the docs sentence-ending rule.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@docs/manage-sandboxes/lifecycle.md`:
- Line 274: The sentence describing how to pass flags to the hosted script
currently ends with a colon; change the trailing punctuation to a period so the
sentence reads "...Pass them after `bash -s --`." Update the line containing the
flags `--yes`, `--keep-openshell`, and `--delete-models` and the text `bash -s
--` to end with a period instead of a colon to comply with the docs
sentence-ending rule.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 6ca3e3ec-e69c-4218-8933-f5dbb472731f

📥 Commits

Reviewing files that changed from the base of the PR and between 141e926 and 00c1025.

📒 Files selected for processing (2)
  • .agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md
  • docs/manage-sandboxes/lifecycle.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • .agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md

@wscurran wscurran added documentation Docs, examples, guides, or messaging need work fix labels May 6, 2026
@wscurran
Copy link
Copy Markdown
Contributor

wscurran commented May 6, 2026

✨ Thanks for submitting this PR that improves the uninstall documentation by showing how to pass flags via the pipe.
This change adds a bash -s -- example to the docs and mirrors it in the skill file to clarify flag usage for the hosted uninstall script.


Related open issues:

@latenighthackathon latenighthackathon force-pushed the docs/uninstall-flag-passing branch 4 times, most recently from 5527403 to 35b8bd7 Compare May 15, 2026 02:08
…VIDIA#2357)

Reporter @subrnath: the quickstart shows `curl ... | bash` for the
hosted uninstall.sh but does not show how to pass --yes,
--keep-openshell, or --delete-models through the curl pipe. Trying
the obvious `curl ... | bash --yes` errors out because flags before
the pipeline target hit `bash` itself.

Add a single example demonstrating the `bash -s -- <flags>` form right
after the existing curl|bash one. The same three flags already
documented in the table above for `nemoclaw uninstall` work for the
hosted form too. Mirrored into the
nemoclaw-user-manage-sandboxes skill.

Closes NVIDIA#2357

Signed-off-by: latenighthackathon <latenighthackathon@users.noreply.github.com>
…ample

CodeRabbit flagged that the new uninstall.sh flag-passing example used
```bash``` while the dominant convention in this docs tree is ```console
with a leading `$ ` prompt. Convert the new fence to match (21 of the
24 fenced blocks in lifecycle.md already use console). Mirror the same
change into the user-manage-sandboxes skill.

Signed-off-by: latenighthackathon <latenighthackathon@users.noreply.github.com>
The sentence introducing the bash -s -- example currently ends with a
colon. The project docs guideline reserves colons for introducing
lists, so use a period instead. Code-block proximity still ties the
example to the prose.

Signed-off-by: latenighthackathon <latenighthackathon@users.noreply.github.com>
@latenighthackathon latenighthackathon force-pushed the docs/uninstall-flag-passing branch from a2e2770 to 987046f Compare May 18, 2026 03:02
@wscurran wscurran added the v0.0.46 Release target label May 19, 2026
ericksoa added 2 commits May 19, 2026 18:07
…assing

Signed-off-by: Aaron Erickson <aerickson@nvidia.com>

# Conflicts:
#	docs/manage-sandboxes/lifecycle.mdx
Signed-off-by: Aaron Erickson <aerickson@nvidia.com>
@ericksoa ericksoa merged commit 6d910d3 into NVIDIA:main May 20, 2026
16 checks passed
@latenighthackathon latenighthackathon deleted the docs/uninstall-flag-passing branch May 20, 2026 02:12
@miyoungc miyoungc mentioned this pull request May 20, 2026
12 tasks
miyoungc added a commit that referenced this pull request May 20, 2026
## Summary
Refreshes the NemoClaw docs for v0.0.46 by updating version metadata,
release notes, and generated user skills. The refresh also keeps public
docs aligned with the docs skip list by removing non-public experimental
references from the generated output.

## Related Issue
None.

## Changes
- #3744 and #3824 -> `docs/about/release-notes.mdx`: Added Windows
bootstrap and WSL express install coverage for v0.0.46.
- #3392 -> `docs/manage-sandboxes/messaging-channels.mdx`,
`docs/reference/commands.mdx`, `docs/reference/network-policies.mdx`,
and policy examples: Refreshed public messaging channel docs around
WhatsApp and matching policy presets.
- #3742, #3767, #3732, #3786, #3777, and #3808 ->
`docs/about/release-notes.mdx`: Added release-note coverage for Hermes
managed tools, Bedrock Runtime endpoint detection, WSL Ollama proxying,
Model Router Python fallback, plugin command registration, and
tool-catalog latency improvements.
- #3124 -> `docs/about/release-notes.mdx`: Added release-note coverage
for hosted uninstall flag guidance.
- Generated `nemoclaw-user-*` skills from the updated MDX docs for the
v0.0.46 release.

## Type of Change
- [ ] Code change (feature, bug fix, or refactor)
- [ ] Code change with doc updates
- [x] 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
- [x] No secrets, API keys, or credentials committed
- [x] Docs updated for user-facing behavior changes
- [ ] `make docs` builds without warnings (doc changes only)
- [x] Doc pages follow the [style
guide](https://github.com/NVIDIA/NemoClaw/blob/main/docs/CONTRIBUTING.md)
(doc changes only)
- [ ] New doc pages include SPDX header and frontmatter (new pages only)

Verification notes:
- Commit hooks passed, including markdownlint, gitleaks, docs-to-skills
verification, env-var docs, and skills YAML checks.
- `python3 scripts/docs-to-skills.py docs/ .agents/skills/ --prefix
nemoclaw-user --doc-platform fern-mdx` passed.
- `bash test/e2e/e2e-cloud-experimental/check-docs.sh --only-links
--local-only --with-skills` passed.
- `git diff --check` passed.
- `make docs` was attempted but blocked before MDX validation because
`npx` received HTTP 403 fetching `fern-api` from npm.

---
Signed-off-by: Miyoung Choi <miyoungc@nvidia.com>

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Released v0.0.46: improved Windows setup, WhatsApp messaging support,
Hermes sandbox/tool routing, Anthropic endpoint compatibility, Ollama
proxy routing, model-router fallback, OpenClaw plugin/backup
compatibility, sandbox build tooling fixes, and updated uninstall flag
behavior.

* **Documentation**
* Removed WeChat from messaging flows and presets across guides and CLI
docs; clarified onboarding and channel setup for WhatsApp. Clarified
runtime mutability and filesystem (Landlock) behavior — some changes
require sandbox rebuilds; prefer host-side commands for durable config.

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NemoClaw/pull/3911?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
@wscurran wscurran added bug-fix PR fixes a bug or regression and removed fix labels Jun 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug-fix PR fixes a bug or regression documentation Docs, examples, guides, or messaging need work v0.0.46 Release target

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Uninstall flag documentation not correct

5 participants