Essential Development Environment

Code name: essential-dev

Core development environment with Git integration, Markdown support, and essential editor enhancements. Perfect base for all development projects.

Also included automatically: repairs broken host paths in your git config and restores your SSH commit-signing key on every attach, on both local and cloud containers, with nothing to set up on your end — see helpers4-common for how it works.

Features

Git Integration: History and graph visualization
Markdown Support: Full markdown editing with preview and linting
Editor Enhancements: Multi-cursor, code comparison, local history
File Format Support: YAML, JSON, CSV, XML, Makefile support out-of-box
Zero Configuration: Works out-of-the-box, no options needed

What’s Included

Git & Version Control

donjayamanne.githistory - View and search git log
the0807.git-graph-plus - Git graph visualization

Conventional Commits + gitmoji guidance is provided as AI instructions by the copilot-dev feature, not a standalone linting extension — add copilot-dev for that.

AI Assistant

Not included here — add the copilot-dev feature for GitHub Copilot Chat and AI generation instructions, or github-dev for the gh CLI and GitHub pull request/issue/Actions extensions.

Editor Enhancements

cardinal90.multi-cursor-case-preserve - Smart multi-cursor case handling
moshfeu.compare-folders - Folder comparison
xyz.local-history - Local file history
editorconfig.editorconfig - EditorConfig support

Markdown & Documentation

yzhang.markdown-all-in-one - Complete markdown support
davidanson.vscode-markdownlint - Markdown linting
bierner.markdown-mermaid - Mermaid diagram support

File Format Support

redhat.vscode-yaml - YAML syntax and validation
redhat.vscode-xml - XML support
ms-vscode.vscode-json - JSON editing
adamraichu.zip-viewer - ZIP archive preview
mechatroner.rainbow-csv - CSV/TSV highlighting
ms-vscode.makefile-tools - Makefile support

Usage

Basic Setup

Add this feature to your devcontainer.json:

{
    "features": {
        "ghcr.io/helpers4/devcontainer/essential-dev:1": {}
    }
}

That’s it! All extensions and settings are applied automatically.

Combining with Other Features

With TypeScript Development

{
    "features": {
        "ghcr.io/helpers4/devcontainer/essential-dev:1": {},
        "ghcr.io/helpers4/devcontainer/typescript-dev:1": {},
        "ghcr.io/helpers4/devcontainer/package-auto-install:1": {},
        "ghcr.io/helpers4/devcontainer/dotfiles-sync:1": {}
    }
}

Full Development Stack

{
    "features": {
        "ghcr.io/helpers4/devcontainer/essential-dev:1": {},
        "ghcr.io/helpers4/devcontainer/vite-plus:1": { "installOxc": true },
        "ghcr.io/helpers4/devcontainer/typescript-dev:1": {},
        "ghcr.io/helpers4/devcontainer/package-auto-install:1": {},
        "ghcr.io/helpers4/devcontainer/git-absorb:1": {},
        "ghcr.io/helpers4/devcontainer/dotfiles-sync:1": {}
    }
}

Terminal Shell Integration

VS Code Shell Integration works automatically in any devcontainer, including this one — it’s a VS Code client capability, not something this feature configures. For zsh, bash, or fish, it provides command awareness, exit-code indicators (✓/✗), run history, smart suggestions, and command decorations.

Not Included (By Design)

Language-Specific Tools

TypeScript indexing - Use typescript-dev feature instead
Tailwind CSS - Add as needed per project
React/Vue snippets - Add per framework

Code Formatters

Oxc/Prettier - Use vite-plus feature instead

Testing

Vitest - Use vite-plus feature instead

Version History

v1.2.4: Removed install.sh’s “Configure VS Code shell integration” loop — it grepped shell config files and printed a status line, but never wrote anything; shell integration is a VS Code client capability, not something this feature configures. The “Terminal Shell Integration” section above no longer claims this feature enables it either.
v1.2.3: Documentation only, no functional change — the previous wording sweep made the JSON description field far too long, shifting focus away from the feature itself onto the self-heal side benefit. Shortened to 5 words and kept generic (no implementation detail like “git config”), matching the original’s brevity and level of detail.
v1.2.2: Documentation only, no functional change — the self-heal callout above (and the JSON description field) led with internal jargon (“helpers4’s self-heal”) instead of the actual benefit; reworded to lead with what it does, with the full mechanism staying in helpers4-common’s own README.
v1.2.1: Documentation only, no functional change — github.copilot, github.copilot-chat and vivaxy.vscode-conventional-commits, along with the PR-support and conventional-commits claims in the intro and Features list, haven’t shipped with this feature’s manifest since the AI/Copilot tooling was extracted into github-dev and copilot-dev; the README now matches the manifest and points there instead.
v1.2.0: Documentation only, no functional change — mentions that helpers4-common’s automatic git-config self-heal (see above) comes along with this feature.