Repository navigation
bug(cli): sandbox help references unpublished Python image #2888
Description
Activity
📋 triage-agent
Triage Assessment
Classification: validated-bug
Summary
Confirmed that the built-in sandbox help advertises an unavailable
pythonsource. The current stable release remainsv0.0.111, so the report is not fixed in a newer release.Investigation
crates/openshell-cli/src/main.rshard-codesopenshell sandbox create --from pythoninSANDBOX_EXAMPLES. The published quickstart and sandbox documentation use the availablebasecommunity source instead. Incrates/openshell-cli/src/run.rs, an existing barepythondirectory is treated as a local Dockerfile context; without a Dockerfile it returns the reportedNo Dockerfile found in directory: pythonerror.The issue has no prior triage assessment or identified duplicate.
Suggested fix scope: replace the stale help example with
--from base(or another verified published source) and add a focused CLI-help regression assertion so the example remains intentional and discoverable.Impact Signals
- Affected users/scope: Users following the built-in CLI example can fail before creating their first sandbox.
- Regression: Unknown.
- Workaround: Use
openshell sandbox create --from baseor a full image reference. - Evidence quality: High: direct current-source inspection and alignment with published documentation.
Human Decision Required
Decide whether OpenShell should address this issue. If yes, apply
state:accepted, associate it with a roadmap item, or do both, and decide whether the work remains human-owned. If no, close it as not planned and record the rationale.This is obsolete as #3386 merged
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 --helprecommendsopenshell sandbox create --from python, but OpenShell Community does not publish apythonsandbox. The CLI consequently treatspythonas 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
baseimage reference, which defeats the purpose of the built-in quickstart example.Acceptance Criteria
Reproduction Steps
openshell sandbox --helpand observe theopenshell sandbox create --from pythonexample.openshell sandbox create --from python.No Dockerfile found in directory: python.Environment
Logs