pi
703edbe4a1
Added: - generate-config.py registers mempalace as a remote MCP endpoint when MEMPALACE_REMOTE_URL is set (MEMPALACE_REMOTE_TOKEN -> Bearer), else the local stdio command as before. Same env contract as pi-devbox's bridge. - docker-compose.mempalace.yml: optional shared server (mempalace-mcp --transport http), loopback-bound by default. - compose (both) + .env.example(.shared): MEMPALACE_REMOTE_URL/TOKEN + local-vs-external docs. Fixed: - validate.yml: skip validate-base/validate-omos on base-changing commits (base-change-warning now exports base_changed). Previously a commit that changed the base AND tightened smoke-test.sh in lockstep (v2.4.0 nano/micro) hard-failed against the stale base-latest until the release rebuilt it. actionlint clean. README + CHANGELOG (Unreleased).
167 lines
7.6 KiB
YAML
167 lines
7.6 KiB
YAML
# opencode-devbox docker-compose
|
|
#
|
|
# Usage:
|
|
# cp .env.example .env # configure your provider and keys
|
|
# docker compose up -d
|
|
# docker compose exec -u developer devbox opencode
|
|
#
|
|
# Or for interactive one-shot:
|
|
# docker compose run --rm devbox
|
|
|
|
# Pin the project name so named volumes survive directory renames.
|
|
# Without this, Docker Compose derives the project name from the
|
|
# directory basename — renaming the dir orphans all existing volumes.
|
|
name: opencode-devbox
|
|
|
|
services:
|
|
devbox:
|
|
image: joakimp/opencode-devbox:latest
|
|
# For multi-agent orchestration, use the omos variant instead:
|
|
# image: joakimp/opencode-devbox:latest-omos
|
|
#
|
|
# To build from source instead of pulling from Docker Hub, uncomment:
|
|
# build:
|
|
# context: .
|
|
# args:
|
|
# INSTALL_GO: "false"
|
|
# INSTALL_OMOS: "false"
|
|
# # INSTALL_OPENCODE: "true"
|
|
container_name: opencode-devbox
|
|
stdin_open: true
|
|
tty: true
|
|
env_file:
|
|
- .env
|
|
environment:
|
|
- TERM=xterm-256color
|
|
- GITHUB_PERSONAL_ACCESS_TOKEN=${GITHUB_PERSONAL_ACCESS_TOKEN:-}
|
|
- GITEA_ACCESS_TOKEN=${GITEA_ACCESS_TOKEN:-}
|
|
- GITEA_HOST=${GITEA_HOST:-}
|
|
# MemPalace transport: leave empty for a LOCAL per-container palace
|
|
# (default). Set MEMPALACE_REMOTE_URL to share ONE external MemPalace
|
|
# across containers/harnesses; MEMPALACE_REMOTE_TOKEN is an optional
|
|
# bearer token. See .env.example.
|
|
- MEMPALACE_REMOTE_URL=${MEMPALACE_REMOTE_URL:-}
|
|
- MEMPALACE_REMOTE_TOKEN=${MEMPALACE_REMOTE_TOKEN:-}
|
|
volumes:
|
|
# Host workspace — mount your project here
|
|
- ${WORKSPACE_PATH:-.}:/workspace
|
|
|
|
# SSH keys (read-only) — for git push/pull
|
|
- ${SSH_KEY_PATH:-~/.ssh}:/home/developer/.ssh:ro
|
|
|
|
# Optional: mount skillset repo for automatic skill/instruction deployment.
|
|
# The entrypoint runs deploy-skills.sh --bootstrap on start, creating
|
|
# relative symlinks that resolve inside the container regardless of
|
|
# where the repo lives on the host. Set SKILLSET_PATH in .env.
|
|
# - ${SKILLSET_PATH}:/home/developer/skillset
|
|
|
|
# Persist opencode config (opencode.jsonc, oh-my-opencode-slim.json,
|
|
# instructions, etc.) across container recreations. Auto-generated on
|
|
# first start from env vars by generate-config.py and the skillset
|
|
# deploy script. Using a named volume (not a host bind mount) keeps
|
|
# the container's skill/instruction symlinks independent from the host,
|
|
# allowing both native and containerized opencode on the same machine.
|
|
- devbox-opencode-config:/home/developer/.config/opencode
|
|
# Legacy pi config volume (pi was removed in v2.0.0). Left commented so
|
|
# fresh installs carry no dead weight. If you are UPGRADING from a
|
|
# pre-v2.0.0 image and had global npm packages installed via
|
|
# `npm install -g` (they lived under ~/.pi/npm-global), uncomment this
|
|
# for ONE container start: entrypoint-user.sh's migration shim copies
|
|
# them to ~/.config/opencode/npm-global, after which you can remove it.
|
|
# - devbox-pi-config:/home/developer/.pi
|
|
# Persist the generated LAN-jump keypair (~/.ssh-local) across recreates.
|
|
# setup-lan-access.sh generates this key once and reuses it; persisting
|
|
# it means you authorize it on the host ONCE rather than re-authorizing
|
|
# after every `docker compose up --force-recreate`.
|
|
- devbox-ssh-local:/home/developer/.ssh-local
|
|
|
|
# NOTE: Do NOT bind-mount ~/.agents/skills/ from the host. The
|
|
# container manages its own skills directory independently — the
|
|
# entrypoint deploys skills from the skillset repo on each start.
|
|
# Sharing it with the host causes symlink conflicts (relative paths
|
|
# differ between host and container filesystem namespaces).
|
|
|
|
# Optional: mount neovim config from host (plugins auto-install on first start)
|
|
# - ~/.config/nvim:/home/developer/.config/nvim:ro
|
|
|
|
# Optional: persist opencode data (auth, memory, etc.)
|
|
- devbox-data:/home/developer/.local/share/opencode
|
|
|
|
# Optional: persist opencode TUI settings (theme, toggles, etc.)
|
|
- devbox-state:/home/developer/.local/state/opencode
|
|
|
|
# Persist bash history across container recreations.
|
|
# Without this, ~/.bash_history is lost on 'docker compose up --force-recreate'.
|
|
- devbox-shell-history:/home/developer/.cache/bash
|
|
|
|
# Persist zoxide directory history ('z <fragment>' to jump).
|
|
- devbox-zoxide:/home/developer/.local/share/zoxide
|
|
|
|
# Optional: override baked shell defaults with your host's rc files.
|
|
# The image ships sensible defaults (history tuning, prefix-search on
|
|
# Up/Down arrows, fzf/zoxide integration). Uncomment to use your own:
|
|
#
|
|
# NOTE: Single-file bind-mounts break when editors use atomic save
|
|
# (vim, VS Code, sed -i write a temp file then rename() over the
|
|
# original, creating a new inode the container never sees). This is a
|
|
# kernel limitation, not Docker-specific. If host edits stop appearing
|
|
# in the container, mount the parent directory instead — see the
|
|
# "Shell defaults" section in README.md.
|
|
# - ~/.bash_aliases:/home/developer/.bash_aliases:ro
|
|
# - ~/.inputrc:/home/developer/.inputrc:ro
|
|
|
|
# Optional: host-owned shell config + LAN jump overrides (recommended
|
|
# over the single-file ~/.bash_aliases mount above — it's a directory,
|
|
# so it survives editors' atomic-save). The image's ~/.bash_aliases
|
|
# sources ~/.config/devbox-shell/bash_aliases if present, and
|
|
# setup-lan-access.sh reads ~/.config/devbox-shell/ssh-lan.conf for
|
|
# named-peer `ProxyJump host` overrides (see ssh-lan.conf.example).
|
|
# - ~/.config/devbox-shell:/home/developer/.config/devbox-shell:ro
|
|
|
|
# Optional: persist uv data (Python installs, tool installs)
|
|
# Without this, 'uv python install' must be re-run after container removal.
|
|
- devbox-uv:/home/developer/.local/share/uv
|
|
|
|
# Optional: persist Rust toolchains and cargo data
|
|
# Without this, 'rustup-init' must be re-run after container removal.
|
|
# - devbox-rustup:/home/developer/.rustup
|
|
# - devbox-cargo:/home/developer/.cargo
|
|
|
|
# Optional: persist VS Code server and extensions across container recreations
|
|
# - devbox-vscode:/home/developer/.vscode-server
|
|
|
|
# Persist neovim plugin/Mason data (avoids re-downloading on every recreate)
|
|
- devbox-nvim-data:/home/developer/.local/share/nvim
|
|
|
|
# Optional: persist MemPalace data (conversation memory, knowledge graph,
|
|
# embeddings). Applies to the LOCAL palace only (the default, when
|
|
# MEMPALACE_REMOTE_URL is unset). Without this, palace data is lost on
|
|
# container recreation. In EXTERNAL mode the shared server owns the data,
|
|
# so this volume is irrelevant.
|
|
# - devbox-palace:/home/developer/.mempalace
|
|
|
|
# Optional: persist ChromaDB embedding model cache (~79 MB, downloaded on
|
|
# first mempalace search). Without this, the model re-downloads on every
|
|
# container recreation. Separate from palace data — model cache is
|
|
# disposable, palace data is precious.
|
|
# - devbox-chroma-cache:/home/developer/.cache/chroma
|
|
|
|
# Optional: AWS credentials/SSO config (not read-only — SSO writes token cache)
|
|
# - ~/.aws:/home/developer/.aws
|
|
|
|
volumes:
|
|
devbox-opencode-config:
|
|
# devbox-pi-config: # legacy (pi removed v2.0.0) — uncomment with the mount above only to migrate old global npm packages
|
|
devbox-ssh-local:
|
|
devbox-data:
|
|
devbox-state:
|
|
devbox-shell-history:
|
|
devbox-zoxide:
|
|
devbox-nvim-data:
|
|
devbox-uv:
|
|
# devbox-palace:
|
|
# devbox-chroma-cache:
|
|
# devbox-rustup:
|
|
# devbox-cargo:
|
|
# devbox-vscode:
|