OpenCode

This example installs OpenCode in a microVM and opens its terminal UI in a project mounted from your host. OpenCode edits the source checkout directly while its tools and dependencies stay inside the sandbox.

Run OpenCode

Start OpenCode

Replace ./my-project with the project directory you want OpenCode to work on:

msb run -t --name opencode-demo --replace \
  --cpus 2 --memory 2G --root-disk 4G \
  --mount-dir ./my-project:/workspace:rw \
  --workdir /workspace \
  node:24-bookworm-slim -- sh -lc '
    apt-get update &&
    apt-get install -y --no-install-recommends ca-certificates git &&
    npm install -g opencode-ai@1.18.4 &&
    exec opencode
  '

msb run -t --name opencode-demo --replace `
  --cpus 2 --memory 2G --root-disk 4G `
  --mount-dir ./my-project:/workspace:rw `
  --workdir /workspace `
  node:24-bookworm-slim -- sh -lc '
    apt-get update &&
    apt-get install -y --no-install-recommends ca-certificates git &&
    npm install -g opencode-ai@1.18.4 &&
    exec opencode
  '

The first run downloads the package and may take a couple of minutes. OpenCode should render its prompt and offer /connect for provider setup. Its XDG configuration, provider connections, and session data live on the sandbox’s 4 GiB root disk and remain available when the sandbox stops and starts.

For an isolated workspace, or when using microsandbox cloud, replace --mount-dir ./my-project:/workspace:rw with --copy-dir ./my-project:/workspace. To try the TUI without a project, use --mkdir /workspace instead.

Start another session

After leaving OpenCode, return to the same sandbox and workspace with:

msb exec -t opencode-demo -- opencode

Verify the installation

Exit the TUI, then run:

msb exec opencode-demo -- opencode --version

The pinned example prints 1.18.4.

Review or export changes

With the default writable mount, changes are already in the host checkout. Review the diff from either side of the mount:

msb exec opencode-demo -- sh -lc 'cd /workspace && git status --short && git diff --stat && git diff'

If you chose the isolated --copy-dir alternative, export a patch from the sandbox:

msb exec opencode-demo -- sh -lc 'cd /workspace && git add -N . && git diff --binary > /tmp/opencode.patch'

Copy the patch to the host:

msb cp opencode-demo:/tmp/opencode.patch ./opencode.patch

Check that it applies cleanly before applying it:

git apply --check ./opencode.patch

Clean up

Remove the sandbox:

msb rm -f opencode-demo

Removing the sandbox also removes its provider connections, sessions, and OpenCode configuration. Changes made through the default workspace mount remain in the host checkout. Never copy an agent’s entire home directory back to the host.

Reference

OpenCode installation

Agents

CI/CD

Docker

Sandbox Workflows

Automation & Tooling

Data & Observability

Run OpenCode

Reference

​Run OpenCode

​Reference

Run OpenCode

Reference