Pi Coding Agent

Images#

• ubuntu: Ubuntu 24.04 without a browser. latest points here, and the CI recipes use it.
  • Base: devbox:ubuntu-full
  • Tags: ubuntu, latest, pi-agent-<version>
  • Included software: Pi and the devbox full tier
• ubuntu-browser: Ubuntu 24.04 with headless Chromium, the default in the local recipes.
  • Base: devbox:ubuntu-browser
  • Tags: ubuntu-browser
  • Included software: Pi and the devbox browser tier
• alpine: Alpine 3.24 without a browser.
  • Base: devbox:alpine-full
  • Tags: alpine
  • Included software: Pi and the devbox full tier
• alpine-browser: Alpine 3.24 with Chromium.
  • Base: devbox:alpine-browser
  • Tags: alpine-browser
  • Included software: Pi and the devbox browser tier

Pull ghcr.io/hambn/pi-agent:<tag> or docker.io/hambn/pi-agent:<tag>. pi-agent-<version> names the Pi npm release in the current ubuntu build. All tags move when the image is rebuilt; pin a digest to keep one build.

Included software#

• Pi
  • Command: pi
  • Source: npm package @earendil-works/pi-coding-agent, installed with --ignore-scripts and pinned in the Dockerfile (opens in new tab)

Git, Node.js, Python, Go, the Docker CLI, and the other devbox tools come from the devbox full tier. The *-browser variants add the browser tier.

Use cases#

• Interactive coding on a local checkout with Docker, including hosts that load the image from a saved tar.
• Repeatable local sessions with Docker Compose, with an air-gapped Compose file.
• Rootless sessions on a workstation with Podman.
• Code review in CI on GitHub pull requests with GitHub Actions or on GitLab merge requests with GitLab CI.

Sources#

• Pi repository (opens in new tab)
• npm package @earendil-works/pi-coding-agent (opens in new tab)
• Pi documentation (opens in new tab)
• Pi provider setup (opens in new tab)