hambn/pi-agent repository overview

⁠Pi Coding Agent

Pi⁠, a small terminal coding agent that you extend with your own tools and prompts, on the devbox⁠ development image. Pi works with Anthropic, OpenAI, Google, and other model providers. The entrypoint is pi, and the container starts in /workspace as sysadmin (UID 1000). No credentials are stored in the image.

• Source: tools/ai/pi-agent/⁠
• Docs: tool-containers.hgh.dev/docs/ai/pi-agent/⁠

⁠Contents

• Images⁠
• Included software⁠
• Use cases⁠
• Sources⁠

⁠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⁠

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⁠
• npm package @earendil-works/pi-coding-agent⁠
• Pi documentation⁠
• Pi provider setup⁠