Top of page

The OpenCode workstation you run.

OpenCode, Claude Code and developer tools in Docker. Your projects and settings stay in persistent folders.

Inside a fresh install

These views come from a local HolyCode validation build. The example uses local files.

Choose a screenshot

Project folder picker

OpenCode folder picker showing the mounted sample project.

OpenCode 1.19.3 · local validation build

The real folder picker is open for the mounted sample project.

An empty session draft

OpenCode with an empty new-session draft and disabled Send action.

OpenCode 1.19.3 · local validation build

No prompt has been sent. The draft shows no model response.

Optional Paperclip setup

Paperclip first-admin setup screen before an account is created.

Paperclip 2026.831.1 · local validation build

Paperclip is enabled for this capture. First-admin setup is shown; no account was created.

About these captures

Local validation build

Captured states

OpenCode shows a sample folder and an empty draft; no prompt was sent. Paperclip shows first-admin setup; no account was created.

Build and originals

The capture record identifies the local image, source versions and six unchanged original screenshots.

Release security

These are local-build UI captures. Released-image security evidence is separate.

Know what you’re installing

Included

OpenCode and Claude Code, plus git, lazygit, ripgrep, fd, fzf, bat, delta, tmux and browser tools.

Chromium, Playwright, Xvfb and Lighthouse are bundled. Read the browser guidance before automation.

Optional

Paperclip adds an agent board on port 3100. It is disabled by default.

Configure Paperclip
You provide

A Docker host, model-provider access, credentials, backups and updates.

Installer presets

Anthropic, OpenAI, Gemini, Groq, AWS Bedrock, Azure OpenAI

Choose one in the installer. Set its credentials in your host environment.

Versions and component status

Component versions

OpenCode
1.19.5
Claude Code
2.1.318
Node.js
24.22.2
npm
12.2.2
Python
3.13
Paperclip
2026.831.1
Claude Auth
2.2.1

Plugin updates

HOLYCODE_PLUGIN_UPDATE=manual is the default: Claude Auth is installed only when missing, preserving your selected version. HOLYCODE_PLUGIN_UPDATE=auto syncs Claude Auth to the image’s pin at startup, not the latest release or every plugin. No verified token-refresh fix is claimed.

Component status

HolyCode-managed oh-my-openagent: managed installation suspended. Paperclip remains on compatibility hold. Bundled Hermes is unavailable; existing data stays at /home/opencode/.hermes. CLIProxyAPI is external-only; use it as an external endpoint.

Bundled tools

Netlify CLI and serve are removed. Vercel CLI, sharp-cli, concurrently and LHCI are not bundled. Database tools are clients: Prisma, PostgreSQL client 17, Redis tools and SQLite connect to the services you run.

Storage

Claude credentials persist in /home/opencode/.claude/.credentials.json. Keep cache on local disk. For CIFS or SMB mounts, use nobrl,mfsymlinks.

Platforms

The Linux image supports AMD64 and ARM64. Review the storage, snapshot and rollback guidance before updates. Rootless Podman instructions are available.

Configure your workstation.

Choose your options and save the complete Compose file.

Configure HolyCode