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

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.

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/iyaki/devcontainer-features/oh-my-pi:": {
            "version": "latest"
        }
    }
}

$ omp --help

# OMP installed and ready to use

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

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

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/iyaki/devcontainer-features/ralph:": {
            "version": "latest"
        }
    }
}

$ ralph --help

# Ralph script installed and ready to use

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

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/iyaki/devcontainer-features/lefthook:": {
            "version": "latest"
        }
    }
}

$ lefthook version

# Lefthook installed and ready to use

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.

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/iyaki/devcontainer-features/pie:": {
            "version": "latest"
        }
    }
}

$ pie --version

# PIE installed and ready to use

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.

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/devcontainers/features/php": {
            "version": "8.4"
        },
        "ghcr.io/iyaki/devcontainer-features/pie-extensions:": {
            "extensions": "apcu/apcu,xdebug/xdebug"
        }
    }
}

$ php -m | grep -E 'apcu|xdebug'

# Extensions installed and enabled

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.

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/iyaki/devcontainer-features/phpantom:": {
            "version": "latest"
        }
    }
}

$ phpantom_lsp --version

# PHPantom installed and ready to use

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.