joakimp
5d472bd41f
Replace the 1-line placeholder with a proper Hub README: image variants table, quick start (docker run + docker compose), inherited-from-base + added-by-pi-devbox feature lists, versioning scheme, persistent volumes table, user-installed pi packages note, source links. Already PATCH'd live on Docker Hub manually — this commit keeps the in-repo file in sync so the next tag-triggered update-description job won't roll it back to the stub.
pi-devbox
A Docker container image with pi coding-agent pre-installed, built on the opencode-devbox base image.
What's inside
Built on opencode-devbox:base-latest, which provides:
- Debian trixie (stable base)
- Node.js (LTS), uv (Python), rustup (Rust on-demand)
- AWS CLI v2
- MemPalace + MCP server (persistent agent memory across sessions)
- Gitea MCP server
- Dev tools: neovim (LazyVim), tmux, bat, eza, fzf, zoxide, ripgrep, git-lfs, make
- Shell: bash with history tuning, prefix-search, fzf/zoxide integration
This image adds:
- pi (
@earendil-works/pi-coding-agent) — baked at/usr/bin/pi - pi-toolkit — keybindings, env loader, settings template (cloned to
/opt/pi-toolkit) - pi-extensions — ext-toggle, todo, ssh-controlmaster, notify, git-checkpoint, mcp-loader, confirm-destructive (cloned to
/opt/pi-extensions) - mempalace bridge —
mempalace.tsextension symlinked from/opt/mempalace-toolkit
Quick start
cp .env.example .env
# edit .env — set WORKSPACE_PATH, GIT_USER_NAME, GIT_USER_EMAIL
docker compose run --rm devbox
# inside the container:
pi
Versioning
Tags follow the pi npm version: v0.74.0, v0.75.0, etc.
latest always points at the most recent release.
Persistence
| Volume | What it holds |
|---|---|
devbox-pi-config |
pi settings, extensions toggle state, sessions (~/.pi/) |
devbox-shell-history |
bash history |
devbox-zoxide |
zoxide directory jump history |
devbox-nvim-data |
neovim plugins, Mason packages |
devbox-uv |
uv Python installs and tool cache |
User-installed pi packages
NPM_CONFIG_PREFIX is set to /home/developer/.pi/npm-global, so any pi install npm:... or npm install -g as the developer user lands on the devbox-pi-config volume and survives container recreation and image rebuilds. A user-installed pi wins over the baked binary via PATH order.
Source
- pi-devbox — this repo
- opencode-devbox — base image source
- pi-toolkit
- pi-extensions