Dev Container Features

This repository contains a collection of features that can be used to enhance the development experience in a Visual Studio Code Dev Container.

The features are organized in separate folders and can be used individually in a devcontainer.json file.

Installation

The installation script can be run locally and/or in a devcontainer environment.

When run locally:

• Features are installed in the local environment.
• A devcontainer.json file is optionally created for the remote development experience.

npx tomgrv/devcontainer-features -h

To install only root stubs

npx tomgrv/devcontainer-features -- init

To install a specific devcontainer feature

npx tomgrv/devcontainer-features -- add gitutils

To set up a full dev environment

npx tomgrv/devcontainer-features -- add -a

Features Overview

Feature	Description
GitUtils	Git aliases and workflow automation
GitHooks	Commit hooks: commitlint, prettier, lint-staged
GitVersion	Semantic versioning via GitVersion
Act	Run GitHub Actions locally via nektos/act
PECL	PHP extension installer via PECL
Larasets	Laravel-specific development utilities
Common Utils	Shared utilities used by other features
Gateway	SSL certificate management for corporate networks
Minikube	Local Kubernetes cluster via Minikube
AI Coding	Agent-agnostic AI coding skills + Claude Code GitHub Action

---

GitUtils

A collection of Git aliases, git-flow shortcuts, and interactive utilities for automating Git workflows.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gitutils:5": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add gitutils

---

GitHooks

Configures Git hooks in one step using commitlint, commitizen, lint-staged, prettier, and devmoji.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/githooks:5": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add githooks

---

GitVersion

Installs GitVersion to calculate semantic version numbers from your Git history.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gitversion:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add gitversion

---

Act

Installs nektos/act to run GitHub Actions locally inside the dev container.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/act:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add act

---

PECL

Installs PHP extensions from the PHP Extension Community Library (PECL).

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/pecl:5": {
        "extension": "zip"
    }
}

Quick Install — console

npx tomgrv/devcontainer-features -- add pecl

---

Larasets

Laravel-specific settings, shell utilities, Composer scripts, and VS Code extensions for Laravel development.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/larasets:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add larasets

---

Common Utils

Shared utilities (jq, dos2unix, JSON helpers, logging) used by other features in this collection.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/common-utils:5": {
        "utils": "jq dos2unix"
    }
}

Quick Install — console

npx tomgrv/devcontainer-features -- add common-utils

---

Gateway

Handles SSL inspection certificates for corporate network environments (e.g. Zscaler). Installs the root CA and wraps curl for transparent gateway authentication. Can also be installed on the host to make it ready for devcontainer creation behind the gateway.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gateway:7": {}
}

Quick Install — console (host)

npx tomgrv/devcontainer-features -- add gateway

---

Minikube

Installs Minikube to run a single-node Kubernetes cluster locally inside the dev container.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/minikube:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add minikube

---

AI Coding

Agent-agnostic AI coding skills (.github/skills/) plus the Claude Code GitHub Action for @claude mentions on issues and pull requests.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/ai-coding:7": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add ai-coding

---

Contributing

If you have a feature that you would like to add to this repository, please open an issue or submit a pull request.

License

This repository is licensed under the MIT License.