fix(docs): remove bare npm install that installs placeholder package#761
fix(docs): remove bare npm install that installs placeholder package#761north-echo wants to merge 1 commit intoNVIDIA:mainfrom
Conversation
…older package The docs told users to run `npm install -g nemoclaw`, which resolves to a placeholder 0.1.0 package on npmjs.org and clobbers the real CLI installed from GitHub source. Replace with a reference to the official installer. Fixes NVIDIA#737 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
📝 WalkthroughWalkthroughDocumentation updates to two command reference files clarifying that the Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
There was a problem hiding this comment.
🧹 Nitpick comments (2)
docs/reference/commands.md (1)
23-24: Use active voice instead of passive constructions.Both sentences contain passive voice:
- Line 23: "is the primary interface" — consider "The
nemoclawCLI manages NemoClaw sandboxes" or similar active phrasing- Line 24: "is installed automatically by" — consider "The installer installs it automatically"
As per coding guidelines: "Active voice required. Flag passive constructions."
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@docs/reference/commands.md` around lines 23 - 24, Rewrite the two passive sentences to use active voice: change "The `nemoclaw` CLI is the primary interface for managing NemoClaw sandboxes." to an active form such as "The `nemoclaw` CLI manages NemoClaw sandboxes." and change "It is installed automatically by the [installer](../../README.md#install)." to an active form such as "The [installer](../../README.md#install) installs it automatically." Ensure the text refers to the `nemoclaw` CLI and the installer link exactly as shown so readers can find the installer documentation..agents/skills/docs/nemoclaw-reference/references/commands.md (1)
3-4: Use active voice instead of passive constructions.Both sentences contain passive voice:
- Line 3: "is the primary interface" — consider "The
nemoclawCLI manages NemoClaw sandboxes" or similar active phrasing- Line 4: "is installed automatically by" — consider "The installer (
curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash) installs it automatically"As per coding guidelines: "Active voice required. Flag passive constructions."
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In @.agents/skills/docs/nemoclaw-reference/references/commands.md around lines 3 - 4, The two sentences use passive voice; change them to active voice by rephrasing so the subject performs the action — e.g., replace "The `nemoclaw` CLI is the primary interface for managing NemoClaw sandboxes." with an active sentence like "The `nemoclaw` CLI manages NemoClaw sandboxes." and replace "It is installed automatically by the installer (`curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash`)." with an active sentence like "The installer (`curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash`) installs the `nemoclaw` CLI automatically." Ensure the term `nemoclaw` CLI and the installer command remain in the updated lines.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In @.agents/skills/docs/nemoclaw-reference/references/commands.md:
- Around line 3-4: The two sentences use passive voice; change them to active
voice by rephrasing so the subject performs the action — e.g., replace "The
`nemoclaw` CLI is the primary interface for managing NemoClaw sandboxes." with
an active sentence like "The `nemoclaw` CLI manages NemoClaw sandboxes." and
replace "It is installed automatically by the installer (`curl -fsSL
https://www.nvidia.com/nemoclaw.sh | bash`)." with an active sentence like "The
installer (`curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash`) installs the
`nemoclaw` CLI automatically." Ensure the term `nemoclaw` CLI and the installer
command remain in the updated lines.
In `@docs/reference/commands.md`:
- Around line 23-24: Rewrite the two passive sentences to use active voice:
change "The `nemoclaw` CLI is the primary interface for managing NemoClaw
sandboxes." to an active form such as "The `nemoclaw` CLI manages NemoClaw
sandboxes." and change "It is installed automatically by the
[installer](../../README.md#install)." to an active form such as "The
[installer](../../README.md#install) installs it automatically." Ensure the text
refers to the `nemoclaw` CLI and the installer link exactly as shown so readers
can find the installer documentation.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: b211fa5c-3d01-4909-97ed-ec41fb9f3d9a
📒 Files selected for processing (2)
.agents/skills/docs/nemoclaw-reference/references/commands.mddocs/reference/commands.md
Summary
npm install -g nemoclawfrom docs, which resolves to a placeholder 0.1.0 package on npmjs.org and clobbers the real CLI installed from GitHub sourcedocs/reference/commands.mdand the agent skills reference copyContext
The installer scripts (
scripts/install.sh,install.sh) correctly usenpm install -g git+https://github.com/NVIDIA/NemoClaw.git, and there's even a test asserting the bare form is never used (install-preflight.test.js:284). But the docs page told users to run the barenpm install -g nemoclaw, which pulls the placeholder from npmjs.org.Fixes #737
Test plan
vitest run test/install-preflight.test.js— 11/11 passingnpm install -g nemoclawCo-Authored-By: Claude noreply@anthropic.com
Summary by CodeRabbit