0xspica/opencode-oh-my-openagent repository overview

⁠opencode-oh-my-openagent

opencode-oh-my-openagent is a Docker image for running OpenCode Web. Fetch the latest OpenCode and Oh My OpenAgent at any time, and have them plugin integrated automatically.

On every container start/restart, it can automatically:

• install/update the latest OpenCode
• install/update the latest Oh My OpenAgent
• auto-assemble integration by ensuring the oh-my-openagent plugin is present in OpenCode config

This gives you a reproducible, persistent, and low-maintenance runtime.

⁠Key Features

• Auto-update on restart
  • OpenCode update/install at startup (OPENCODE_AUTO_UPDATE=true)
  • Oh My OpenAgent update/install at startup (OMO_AUTO_INSTALL=true)
• Automatic assembly
  • Initializes config if missing
  • Ensures plugin registration (oh-my-openagent) in opencode.json
• Persistent data
  • The config, data, state, and cache directories, along with the OpenCode binary, are volume-mounted.
• Headless-friendly bootstrap
  • Non-interactive install args by default, suitable for server environments

⁠Startup Workflow

At container startup (entrypoint.sh), the image:

1. Creates required OpenCode directories
2. Installs/Updates OpenCode
3. Creates opencode.json if it does not exist
4. Installs/updates oh-my-openagent (or force reinstalls if enabled)
5. Injects plugin entry (oh-my-openagent) into config if missing
6. Starts OpenCode Web with configured host/port and optional flags

⁠Configuration

⁠Environment Variables

⁠Persistent Volumes

• ./opencode-config → /root/.config/opencode
• ./opencode-data → /root/.local/share/opencode
• ./omo → /root/.omo

Options:

• ./opencode-state → /root/.local/state/opencode
• ./opencode-cache → /root/.cache/opencode
• ./opencode-bin → /root/.opencode/bin
• ./workspace → /workspace

⁠Binary Persistent

/root/.opencode/bin is where the binary files are stored. When this directory is persisted, the behavior depends on environment OPENCODE_AUTO_UPDATE:

• If OPENCODE_AUTO_UPDATE is true: it automatically checks for the latest opencode version, and updates if your local version differs.
• If OPENCODE_AUTO_UPDATE is false: it does not check versions, does not download opencode, and always uses the local version. You can remain on a specific version and manually import the binary.

If this directory is NOT persisted, the container will download the opencode binary every time it starts.

⁠Oh My OpenAgent Configuration

Oh My OpenAgent uses OpenCode Zen’s free GPT-5-Nano model by default. The model ID is: opencode/gpt-5-nano.

The configuration file for Oh My OpenAgent is located at:

./omo/omo.jsonc

Inside the container, the path is:

/root/omo/omo.jsonc

⁠Quick Start (Docker Compose)

services:
  opencode-oh-my-openagent:
    image: 0xspica/opencode-oh-my-openagent
    container_name: opencode-oh-my-openagent
    restart: unless-stopped
    ports:
      - "4096:4096"
    environment:
      OPENCODE_AUTO_UPDATE: "true"
      OMO_AUTO_INSTALL: "true"
      OMO_FORCE_REINSTALL: "false"
    volumes:
      - ./opencode-config:/root/.config/opencode
      - ./opencode-data:/root/.local/share/opencode
      - ./omo:/root/.omo
      - ./workspace:/workspace