Agent Plugin
OpenCode Devcontainers
Adds devcontainer and Git worktree isolation modes to OpenCode for safer parallel development sessions.
What is OpenCode Devcontainers?
OpenCode Devcontainers is a community plugin that gives an OpenCode session two isolation choices. A devcontainer provides a fully described container environment, while a Git worktree offers a lighter parallel checkout. Commands create, list, enter, and remove those workspaces, with supporting behavior for ignored secrets and port allocation. The project is pre-1.0 and not affiliated with the OpenCode team, so teams should test it against their repository workflow before standardizing on it.
Key capabilities
Two isolation levels
Choose a full devcontainer or a lightweight Git worktree per task.
Workspace lifecycle
Creates, lists, enters, and removes isolated environments from OpenCode.
Project continuity
Copies selected ignored secrets and assigns ports so an isolated checkout can run quickly.
Use cases
Parallel feature work
Run independent OpenCode sessions without sharing a working tree.
Reproducible environment
Use the repository's devcontainer definition for tools and dependencies.
Risky dependency changes
Keep installations and build artifacts away from the primary checkout.
Included components
Commands
Isolated Workspace Commands
Provides /devcontainer, /worktree, and /workspaces lifecycle commands.
Installation scope
- OpenCode
- Git for worktree mode
- Docker and @devcontainers/cli for devcontainer mode
- Acceptance of a community pre-1.0 integration