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.ts extension 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