bug(cli): sandbox help references unpublished Python image
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 72/100
Research direction
Start by running openshell sandbox --help and locate the CLI source that defines its sandbox examples. Verify the referenced image is currently published and that openshell sandbox create --from <image> resolves without looking for a local Dockerfile. Update or add the relevant CLI help test, if applicable, and confirm the example works.
Written by the indexing model from the issue text.
Description
User Story
As an OpenShell user, I want the CLI's sandbox examples to reference a published community image so that I can successfully follow the built-in help.
Problem Statement
openshell sandbox --help recommends openshell sandbox create --from python, but OpenShell Community does not publish a python sandbox. The CLI consequently treats python as a local directory and fails because it contains no Dockerfile.
Impact / Why This Matters
Users following the built-in example cannot create a sandbox and may misdiagnose the failure as a gateway or container-runtime problem. The current workaround is to discover a valid image name independently or provide the full community base image reference, which defeats the purpose of the built-in quickstart example.
Acceptance Criteria
- The sandbox help example references a currently published OpenShell Community sandbox.
- The example can resolve without requiring a local Dockerfile named after the example.
- Relevant CLI help tests are updated or added if applicable.
Reproduction Steps
- Install OpenShell 0.0.111.
- Run
openshell sandbox --helpand observe theopenshell sandbox create --from pythonexample. - Run
openshell sandbox create --from python. - Observe
No Dockerfile found in directory: python.
Environment
- OpenShell: 0.0.111
- OS: macOS 26.5.2 on Apple Silicon
- Runtime, deployment, or integration: Homebrew gateway with Docker through Colima
Logs
Error: × No Dockerfile found in directory: python
- Dominant language
- Rust
- Stars
- 8.7k
- Forks
- 1.3k
- Avg merge
- 2d 8h
- Merged PRs (30d)
- 271
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from NVIDIA/OpenShell
-
area:docs
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
state:triage-needed
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
state:triage-needed
Difficulty 1/5 Under an hour Newbie friendliness 90/100
-
area:build spike state:review-ready state:stale
Difficulty 2/5 Half a day Newbie friendliness 68/100
-
area:docs state:stale
Difficulty 1/5 Under an hour Newbie friendliness 82/100
All issues in NVIDIA/OpenShell
Similar issues
-
todo:perf
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
ACP agents get no MCP servers when the thread is created before the project's first worktree loads Openstate:needs triage
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
zed-industries/zed#64611 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
ontola/atomic-server#1625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
objectionary/phie#154 ·