diff --git a/DOCKER_HUB.md b/DOCKER_HUB.md index 0a0c887..69103f1 100644 --- a/DOCKER_HUB.md +++ b/DOCKER_HUB.md @@ -2,6 +2,17 @@ Portable AI developer environment for [opencode](https://opencode.ai). Debian-based, with git, SSH, Node.js, AWS CLI v2, and common dev tools pre-installed. +## Image Variants + +Two image variants are published for each release: + +| Tag | Description | +|---|---| +| `latest` / `vX.Y.Z` | Base image — opencode, Node.js, AWS CLI, dev tools | +| `latest-omos` / `vX.Y.Z-omos` | Base + [oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim) multi-agent orchestration, Bun, and tmux | + +Both variants support `linux/amd64` and `linux/arm64`. + ## Quick Start ```bash @@ -174,6 +185,7 @@ Understanding what survives container restarts and what doesn't: | `/home/developer/.aws` | Host bind mount | ✅ Yes — lives on host | AWS credentials/SSO cache | | `/home/developer/.local/share/opencode` | Named volume (if configured) | ✅ Yes — Docker volume | Session history, memory, auth tokens | | `/home/developer/.config/opencode/opencode.json` | Generated by entrypoint | ❌ No — regenerated each start | Provider config, MCP server definitions | +| `/home/developer/.config/opencode/oh-my-opencode-slim.json` | Generated by entrypoint (OMOS variant) | ❌ No — regenerated each start | Agent/model mappings | ### Key points @@ -220,6 +232,8 @@ GIT_USER_EMAIL=you@example.com services: devbox: image: joakimp/opencode-devbox:latest + # For multi-agent orchestration, use the omos variant instead: + # image: joakimp/opencode-devbox:latest-omos stdin_open: true tty: true env_file: @@ -267,6 +281,8 @@ docker compose run --rm devbox bash # interactive shell ## What's Included +### Base image (`latest`) + - **Debian bookworm-slim** — glibc, full terminal/PTY support - **opencode** — AI coding assistant - **Node.js 22** — for npx-based MCP servers @@ -274,14 +290,73 @@ docker compose run --rm devbox bash # interactive shell - **Dev tools** — git, git-lfs, ssh, ripgrep, fd, fzf, jq, curl, wget, vim, tree - **Non-root user** — runs as `developer` with UID auto-matched to workspace owner (sudo available) -### Optional (build from source) +### OMOS image (`latest-omos`) -The pre-built Docker Hub image ships with the core toolset above. When [building from source](https://gitea.jordbo.se/joakimp/opencode-devbox), additional features are available via build args: +Everything in the base image, plus: + +- **[oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim)** — multi-agent orchestration plugin +- **Bun** — JavaScript runtime required by oh-my-opencode-slim +- **tmux** — terminal multiplexer (used by OMOS for agent pane integration, but also useful on its own for managing multiple terminal sessions) +- **6 specialized agents** — Orchestrator, Explorer, Oracle, Librarian, Designer, Fixer + +### Additional runtimes (build from source) + +When [building from source](https://gitea.jordbo.se/joakimp/opencode-devbox), additional runtimes are available via build args: -- **oh-my-opencode-slim** (`INSTALL_OMOS=true`) — [multi-agent orchestration](https://github.com/alvinunreal/oh-my-opencode-slim) plugin with Bun, tmux, and 6 specialized agents (Orchestrator, Explorer, Oracle, Librarian, Designer, Fixer) - **Python 3** (`INSTALL_PYTHON=true`) — Python 3 + pip + venv - **Go** (`INSTALL_GO=true`) — Go toolchain +## oh-my-opencode-slim (OMOS variant) + +The `-omos` image variant includes [oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim), which adds a multi-agent layer on top of opencode. An Orchestrator delegates tasks to specialized agents, each configurable with different models and providers. + +### Quick start with OMOS + +```bash +docker run -it --rm \ + -e OPENAI_API_KEY=your-key \ + -e OPENCODE_PROVIDER=openai \ + -e ENABLE_OMOS=true \ + -v ~/projects:/workspace \ + -v ~/.ssh:/home/developer/.ssh:ro \ + joakimp/opencode-devbox:latest-omos +``` + +On first start, the entrypoint configures oh-my-opencode-slim automatically. The default preset uses OpenAI models. + +### OMOS environment variables + +| Variable | Default | Description | +|---|---|---| +| `ENABLE_OMOS` | `false` | Activate oh-my-opencode-slim on container start | +| `OMOS_TMUX` | `false` | Enable tmux pane integration (watch agents in split panes) | +| `OMOS_SKILLS` | `true` | Install recommended skills (simplify, agent-browser, cartography) | +| `OMOS_RESET` | `false` | Force regenerate config on next start (backs up existing config) | + +### Custom OMOS configuration + +Mount your own config to control which models power each agent: + +```bash +docker run -it --rm \ + -e ENABLE_OMOS=true \ + -v ./oh-my-opencode-slim.json:/home/developer/.config/opencode/oh-my-opencode-slim.json:ro \ + ... \ + joakimp/opencode-devbox:latest-omos +``` + +See the [oh-my-opencode-slim configuration docs](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/docs/configuration.md) for the full reference. + +### Verifying agents + +After starting opencode with OMOS enabled, run inside the opencode session: + +``` +ping all agents +``` + +All six agents should respond if your provider authentication is working. + ## Source Build from source or contribute: [opencode-devbox on Gitea](https://gitea.jordbo.se/joakimp/opencode-devbox) diff --git a/README.md b/README.md index dde1a20..3d58f0e 100644 --- a/README.md +++ b/README.md @@ -162,6 +162,8 @@ docker compose build --build-arg OPENCODE_VERSION=1.5.0 ### Setup +A pre-built OMOS image is available on Docker Hub as `joakimp/opencode-devbox:latest-omos`. Alternatively, build from source: + **1. Build the image with OMOS support:** ```bash @@ -306,7 +308,7 @@ Container (Debian bookworm) ├── git, ssh, ripgrep, fd, jq, curl, fzf ├── Node.js (for MCP servers) ├── Bun (optional — included with oh-my-opencode-slim) -├── tmux (optional — included with oh-my-opencode-slim) +├── tmux (optional — included with oh-my-opencode-slim, also useful independently) ├── entrypoint.sh (UID adjustment, git config, provider setup) └── /workspace ← your code lives here ```