bug(cli): sandbox help references unpublished Python image
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 8.7k
- Forks
- 1.3k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 253
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
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.
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.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100