docs(reference): document remote-deploy env vars

[latenighthackathon]

Summary

Adds a ### Remote Deployment subsection to the ## Environment Variables reference, documenting the four env vars that src/lib/deploy/index.ts reads for the nemoclaw deploy / nemoclaw onboard --remote flow. Follow-up to #3184: the env-var doc gate currently passes because these vars are accessed via a destructured env.NEMOCLAW_* local that the AST extractor does not flag, but the same users who hit the new gate-enforced sections also hit these deploy knobs and had no doc entry to find them.

Related Issue

Follow-up to #3184. Original umbrella issue #3059 was already substantively addressed by #3184; this PR closes the four remaining deploy-vars gaps from that audit.

Changes

• docs/reference/commands.mdx: new ### Remote Deployment subsection between ### Lifecycle Behavior Flags and ## NemoHermes Alias. One table with four rows: NEMOCLAW_BREV_PROVIDER (default gcp), NEMOCLAW_GPU (default a2-highgpu-1g:nvidia-tesla-a100:1), NEMOCLAW_DEPLOY_NO_CONNECT, NEMOCLAW_DEPLOY_NO_START_SERVICES. Defaults verified against src/lib/deploy/index.ts:295-303.
• .agents/skills/nemoclaw-user-reference/references/commands.md: same subsection added at the corresponding position to keep the auto-generated skill in sync.

Test plan

• prek run clean
• Defaults cross-checked against the current env.NEMOCLAW_* reads in src/lib/deploy/index.ts (the file moved from src/lib/deploy.ts to src/lib/deploy/index.ts upstream)

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

[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]

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 adds a "Remote Deployment" subsection to environment variables, documenting four Brev-specific seed variables—NEMOCLAW_BREV_PROVIDER, NEMOCLAW_GPU, NEMOCLAW_DEPLOY_NO_CONNECT, and NEMOCLAW_DEPLOY_NO_START_SERVICES—used by nemoclaw deploy and nemoclaw onboard --remote.

Changes

Remote Deployment Environment Variables

Layer / File(s)	Summary
Environment Variables Documentation .agents/skills/nemoclaw-user-reference/references/commands.md, docs/reference/commands.md	Adds a "Remote Deployment" subsection documenting Brev/remote-deploy seed vars for nemoclaw deploy and nemoclaw onboard --remote, including defaults for NEMOCLAW_BREV_PROVIDER and NEMOCLAW_GPU, plus NEMOCLAW_DEPLOY_NO_CONNECT and NEMOCLAW_DEPLOY_NO_START_SERVICES to skip post-deploy connect and automatic service startup.

🎯 2 (Simple) | ⏱️ ~10 minutes

🐰 I hopped to the docs and left a sign,

Brev provider and GPU in tidy line,
Flags to skip connect or auto-start,
Now remote deploys follow the chart,
Quiet sandboxes boot on cloud-time.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: adding documentation for remote-deploy environment variables. It is concise, specific, and directly reflects the changeset which adds a 'Remote Deployment' subsection documenting four env vars.
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.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ 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 detailed PR to document remote-deploy env vars. This change aims to improve the accuracy of the documentation by adding a new subsection for remote deployment environment variables.

---

Related open issues:

• #3184 ci: enforce documentation for all user-facing NEMOCLAW_* env vars
• #3059 Missing proper reference of ALL environment variables

[latenighthackathon]

Closing in favor of #4166 which is rebuilt cleanly on current upstream/main with the same content. Cheers!