Dev Container Features

This repository contains a collection of dev container Features for use with Dev Containers.

This repository contains the following Features:

• ralph - AI Agentic Loop shell runner for spec-driven development workflows
• lefthook - Git hooks manager for fast and powerful Git hook workflows
• oh-my-pi - AI coding agent toolkit for terminal-based development
• pie - PHP Installer for Extensions (PIE), the official PECL replacement, as a self-contained static binary
• pie-extensions - Installs PHP extensions using PIE into a PHP installation
• phpantom - PHPantom, a fast and lightweight PHP language server written in Rust, as a self-contained binary

oh-my-pi

Installs omp (Oh My Pi) from can1357/oh-my-pi GitHub Releases — an AI coding agent toolkit for terminal-based development. Full options and notes: src/oh-my-pi/README.md.

$ omp --help
# OMP installed and ready to use

Each sub-section below shows a sample devcontainer.json alongside example usage of the Feature.

ralph

Installs the ralph CLI from iyaki/specralph for running AI Agentic Loop workflows. Full options and notes: src/ralph/README.md.

$ ralph --help
# Ralph script installed and ready to use

lefthook

Installs lefthook from GitHub Releases. Full options and notes: src/lefthook/README.md.

$ lefthook version
# Lefthook installed and ready to use

pie

Installs PIE — the official PHP extension installer (replaces PECL) — from php/pie GitHub Releases as a self-contained static binary. Full options and notes: src/pie/README.md.

$ pie --version
# PIE installed and ready to use

pie-extensions

Installs PHP extensions using PIE — the official PHP extension installer (replaces PECL) — into the PHP installation provided by a PHP runtime feature. Requires the pie feature and a PHP runtime with build tools (e.g. ghcr.io/devcontainers/features/php). Full options and notes: src/pie-extensions/README.md.

$ php -m | grep -E 'apcu|xdebug'
# Extensions installed and enabled

phpantom

Installs PHPantom — a fast, lightweight PHP language server written in Rust — from PHPantom-dev/phpantom_lsp GitHub Releases as a self-contained binary bundled with phpstorm-stubs, so it needs no PHP runtime. Full options and notes: src/phpantom/README.md.

$ phpantom_lsp --version
# PHPantom installed and ready to use

Repo and Feature Structure

Similar to the devcontainers/features repo, this repository has a src folder. Each Feature has its own sub-folder, containing at least a devcontainer-feature.json and an entrypoint script install.sh.

An implementing tool will composite the documented dev container properties from the feature's devcontainer-feature.json file, and execute in the install.sh entrypoint script in the container during build time. Implementing tools are also free to process attributes under the customizations property as desired.