[NemoClaw][all platform] nemoclaw <name> logs --follow fails: OpenShell rejects --follow (unexpected argument)

[eko-liu]

Description

Description

When streaming sandbox logs with nemoclaw logs --follow, the CLI fails with an error that --follow is an unexpected argument, and suggests using -- --follow to pass it through.

NemoClaw’s built-in help documents nemoclaw logs [--follow], so users expect --follow to work. Under the hood, NemoClaw forwards arguments to the OpenShell openshell logs command. Per NVIDIA OpenShell documentation, live log streaming uses --tail, not --follow. Passing --follow to openshell therefore triggers the underlying parser error (e.g. clap-style “unexpected argument”).

The product should either translate --follow to --tail when invoking OpenShell, or update help/docs to only document --tail and remove misleading --follow guidance.

---

Environment

Item	Version / detail
Device	macos
Node.js	(e.g. v20.x / v22.x — fill as on device)
OpenShell CLI	0.0.16 (or your version)
NemoClaw	v0.1.0
OpenClaw	2026.3.11 (if relevant)

Note: Reproduces when nemoclaw is wired to an OpenShell build whose openshell logs subcommand does not define --follow.

---

Steps to Reproduce

1. Complete onboarding so at least one sandbox exists (e.g. test11) and is registered in NemoClaw.
2. Run: nemoclaw logs --follow Example: nemoclaw test11 logs --follow
3. Observe the process exits with an error instead of streaming logs.

---

Expected Result

• nemoclaw logs --follow should stream sandbox logs in real time, or
• Help text should only document flags that OpenShell accepts (e.g. --tail), with no broken --follow example.

Preferred UX: accept --follow as a kubectl-style alias and invoke OpenShell with --tail so existing docs/help keep working.

---

Actual Result

Command fails with an error similar to:error: unexpected argument '--follow' found
tip: to pass '--follow' as a value, use '-- --follow'

Logs are not streamed; user must discover openshell logs --tail or equivalent outside NemoClaw.

---

References

• NVIDIA OpenShell — Manage Sandboxes: openshell logs streaming flag documented as --tail (not --follow).
• macOS: Reproduces consistently with OpenShell 0.0.16 — openshell logs --follow returns unexpected argument '--follow' found; Usage: openshell logs shows no --follow flag.
• DGX Spark (Linux): Not reproduced in our testing — nemoclaw logs --follow appeared to work with the same OpenShell version：0.0.16

Steps to reproduce

No steps provided.

---

[NVB# 6034048]

[hulynn]

@jacobtomlinson @ericksoa @drobison00
Confirmed on OpenShell 0.0.16 — nemoclaw logs --follow fails with "unexpected argument". The NemoClaw help text documents --follow but OpenShell only accepts --tail. This breaks the expected log streaming workflow. Suggest either translating --follow to --tail internally or updating the docs. Would appreciate a fix in the next release as this impacts daily sandbox monitoring.

[ericksoa]

Closed by #1187 — maps --follow to --tail so OpenShell no longer rejects the flag.