Dev Container Features — Maincode

A collection of dev container features maintained by Maincode.

Features

Feature	Description
matilda-code	Installs the Matilda Code CLI — Maincode's Australian-made AI coding agent for the terminal.

Usage

Add a feature to your devcontainer.json:

{
  "image": "mcr.microsoft.com/devcontainers/base:debian",
  "features": {
    "ghcr.io/maincodehq/devcontainer-features/matilda-code:1": {}
  }
}

See each feature's README for available options.

Repository Structure

src/
  matilda-code/
    devcontainer-feature.json   # Feature metadata + options
    install.sh                  # Installation script
    README.md                   # Feature documentation
test/
  matilda-code/
    scenarios.json              # Test scenario definitions
    test.sh                     # Shared test script
.github/
  workflows/
    validate.yml                # Validates feature definitions
    test.yaml                   # Runs scenario tests
    release.yaml                # Publishes features to GHCR

Development

Prerequisites

• Docker
• Node.js (for the devcontainer CLI)
• Dev Containers CLI: npm install -g @devcontainers/cli

Validate

devcontainer features validate src/matilda-code

Test locally

# Run all scenarios
devcontainer features test --features matilda-code --project-folder .

# Run a specific scenario
devcontainer features test --features matilda-code --filter default --project-folder .

Publishing

Features are published automatically to the GitHub Container Registry (GHCR) when a tag matching v* is pushed. The release workflow is defined in .github/workflows/release.yaml.

git tag v1.0.0
git push origin v1.0.0

License

MIT