Shipbox Sandbox Development

This skill enables development using Shipbox sandboxes - isolated Cloudflare containers running the OpenCode agent.

Available MCP Tools

When this skill is active, you have access to these tools via the shipbox-sandbox MCP server:

opencode_run_task

Execute a coding task in a sandbox.

Parameters:

• •task (required): The coding task to execute
• •sessionId (optional): Continue an existing session
• •repository (optional): Git repository URL to clone
• •branch (optional): Branch name (default: main)
• •model (optional): Claude model to use
• •title (optional): Task title

Returns:

• •runId: Use to poll for results
• •sessionId: Use to continue this session
• •webUiUrl: Share with user for real-time progress

opencode_get_result

Get status and result of a task run.

Parameters:

• •runId (required): The run ID from opencode_run_task

Returns:

• •status: started | running | completed | failed
• •result: Final output when completed

opencode_list_runs

List past task runs.

Parameters:

• •sessionId (optional): Filter by session
• •status (optional): Filter by status
• •limit (optional): Max results (default 10)
• •before (optional): Pagination cursor

opencode_preview_worker

Start a miniflare development server.

Parameters:

• •sessionId (required): Active session ID
• •workerPath (optional): Path to worker entry point
• •port (optional): Port number (default 8787)

Returns:

• •previewUrl: URL to test the worker

opencode_deploy_worker

Deploy a worker to production.

Parameters:

• •sessionId (required): Active session ID
• •workerPath (optional): Path to worker entry point
• •name (optional): Worker name

Returns:

• •url: Production URL

Workflow

1. •Start a task: Use opencode_run_task with your task description
2. •Monitor progress: Share the webUiUrl and poll opencode_get_result
3. •Continue work: Use the same sessionId for follow-up tasks
4. •Preview: Use opencode_preview_worker to test workers
5. •Deploy: Use opencode_deploy_worker for production

Example Session

User: Create a simple Cloudflare Worker that returns "Hello World"

1. Call opencode_run_task with task="Create a Cloudflare Worker that returns Hello World on all requests"
2. Share the webUiUrl with the user
3. Poll opencode_get_result until completed
4. Call opencode_preview_worker to start local preview
5. Share the previewUrl for testing
6. When ready, call opencode_deploy_worker

Tips

• •Always share the webUiUrl so users can watch agent progress in real-time
• •Poll every 10-30 seconds for task completion
• •Reuse sessionId for related tasks to maintain workspace state
• •The sandbox persists files between tasks in the same session