Docker containers for running OpenCode with different plugin and agent configurations.

The project uses a base + variant architecture: a shared base image (opencode-base) provides all common dependencies and skills, and each variant adds its own specific plugins, skills, or agent frameworks on top.

A Makefile is provided to build the base and variant images.

# Build all variants (automatically builds base first)
make all

# Build a specific variant
make superpowers
make ralph
make oh-my-opencode
make get-shit-done

# Build only the base image
make base

The build dependency chain is:

opencode-base
  ├── opencode-superpowers
  ├── opencode-ralph
  ├── opencode-oh-my-opencode
  └── opencode-get-shit-done

Images are published to the GitHub Container Registry. You can pull and use them directly without building:

# Pull the base image
docker pull ghcr.io/spiermar/opencode-container-base:latest

# Pull a specific variant
docker pull ghcr.io/spiermar/opencode-container-superpowers:latest
docker pull ghcr.io/spiermar/opencode-container-ralph:latest
docker pull ghcr.io/spiermar/opencode-container-oh-my-opencode:latest
docker pull ghcr.io/spiermar/opencode-container-get-shit-done:latest

Run using the ghcr.io image name:

docker run -d \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e CLI_HOST="0.0.0.0" \
  -p 9898:9898 \
  -v /path/to/workspace:/home/opencode/workspace \
  ghcr.io/spiermar/opencode-container-superpowers:latest

Note: Replace opencode-superpowers with your chosen variant as needed.

All variants share the opencode-base image, which includes:

• OS: Ubuntu (latest)
• Tools: git, curl, jq, make, vim, ripgrep, wget, zip, openssh-client, postgresql-client, GitHub CLI
• Runtime: Node.js LTS (via nvm), Playwright Chromium
• OpenCode CLI: opencode-ai@latest
• Provider: Parasail (pre-configured), Context7, or Tavily (via opencode.json)

The base image comes with the following skill sets:

Anthropic Skills - Document processing and creative/technical skills:

• xlsx - Excel spreadsheet processing
• docx - Word document processing
• pptx - PowerPoint presentation processing
• pdf - PDF document processing
• algorithmic-art - Generative art creation
• brand-guidelines - Brand consistency
• canvas-design - Visual design
• doc-coauthoring - Document collaboration
• frontend-design - UI/UX design
• internal-comms - Internal communications
• mcp-builder - MCP server development
• skill-creator - Custom skill creation
• slack-gif-creator - Slack GIF creation
• theme-factory - Theme styling
• web-artifacts-builder - Web artifact building
• webapp-testing - Web application testing

Note: Some document skills (docx, pdf, pptx, xlsx) are source-available, not Apache 2.0. See anthropics/skills for licensing details.

Spiermar Skills & Agents - Custom skills and agents.

Vercel Labs Skills - Utility skills.

Adds the Superpowers plugin and skills. Includes development workflow skills such as brainstorming, TDD, debugging, code review, and more.

Adds Ralph skills for specialized workflows.

Adds the Oh-My-OpenCode agent framework with specialized sub-agents, each mapped to a Parasail model:

Adds Get-Shit-Done (GSD) - a meta-prompting, context engineering, and spec-driven development system for OpenCode. Includes commands like:

• /gsd:new-project - Initialize a new project with questions, research, requirements, and roadmap
• /gsd:discuss-phase [N] - Capture implementation decisions before planning
• /gsd:plan-phase [N] - Research and plan a phase
• /gsd:execute-phase [N] - Execute all plans in a phase
• /gsd:verify-work [N] - Manual user acceptance testing
• /gsd:quick - Execute ad-hoc tasks with GSD guarantees
• /gsd:progress - Show current progress and next steps

GSD solves context rot by keeping your session fast and responsive through multi-agent orchestration and fresh context windows per task.

The container comes pre-configured with Parasail as the default provider. You can switch to Context7 or Tavily by creating an opencode.json file in your workspace:

{
  "schema": "https://opencode.ai/schemas/opencode.json",
  "model": "claude-sonnet-4-20250514",
  "provider": "context7"
}

Then run with:

docker run -d \
  -e CONTEXT7_API_KEY="your-context7-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers

{
  "schema": "https://opencode.ai/schemas/opencode.json",
  "model": "claude-sonnet-4-20250514",
  "provider": "tavily"
}

Then run with:

docker run -d \
  -e TAVILY_API_KEY="your-tavily-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers

Replace opencode-superpowers below with your chosen variant (opencode-ralph, opencode-oh-my-opencode).

Starts an OpenCode server:

docker run -d \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e CLI_HOST="0.0.0.0" \
  -p 9898:9898 \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers

Optionally set CORS origin:

docker run -d \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e CLI_HOST="0.0.0.0" \
  -e CORS="https://your-domain.com" \
  -p 9898:9898 \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers

Starts a CodeNomad server that exposes OpenCode over HTTPS:

docker run -d \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e CODENOMAD_SERVER_PASSWORD="your-password" \
  -e CLI_HOST="0.0.0.0" \
  -p 9898:9898 \
  -v /path/to/workspace:/home/opencode/workspace \
  -e MODE=codenomad \
  opencode-superpowers

Starts a bash shell for direct interaction:

docker run -it \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e MODE=interactive \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers

Once inside the container, you can run opencode directly.

docker run -d \
  -e PARASAIL_API_KEY="your-api-key" \
  -e GITHUB_TOKEN="your-github-token" \
  -e CLI_HOST="0.0.0.0" \
  -e CLI_PORT=8080 \
  -p 8080:8080 \
  -v /path/to/workspace:/home/opencode/workspace \
  opencode-superpowers