Devcontainers

TL;DR

Devcontainers (community plugin by @athal7) provides isolated branch workspaces for OpenCode using devcontainers (full container isolation) or git worktrees (lightweight filesystem isolation). It adds session state management so the agent remembers your workspace, auto-assigns ports from a configurable range (13000–13099), and automatically copies gitignored secrets (.env, credentials). Add opencode-devcontainers to the plugin array. Note: version 0.x, pre-1.0 software.

Devcontainers is a community plugin (not built by or affiliated with the OpenCode team) for isolated branch workspaces, currently at version 0.x — pre-1.0 software where minor versions may contain breaking changes.

Why devcontainers or worktrees?

Option	Isolation	Best for
Devcontainers	Full container isolation	Different dependencies, databases, runtimes per branch
Git worktrees	Lightweight filesystem isolation	Same dependencies, just different code

Key features

Feature	Description
Session state management	The agent remembers your workspace
Auto-assigned ports	From a configurable range (13000–13099)
Secrets copying	Automatically copies gitignored secrets (.env, credentials, etc.)
Unified management	Workspace creation and cleanup in one place

Installation

Add to ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-devcontainers"]
}