dvt (devtemplate)

Dev-style named devcontainer templates, built and run directly via Docker or Podman.

Templates are fetched from jesserobertson/devcontainers's templates/ directory.

Install

pipx install dvt-cli

For a local checkout instead (e.g. to track main), use pipx install ./dvt from the repo root.

Usage

dvt sync
dvt feature list
dvt init ./my-project
dvt feature add fastapi            # run from inside a project with .devcontainer/devcontainer.json
dvt feature add agent
dvt up my-project
dvt ssh my-project
dvt run -n my-project pytest -q  # run one command inside the workspace, exit with its status
dvt info                        # from inside my-project - no name needed

Development

dvt is developed inside the jesserobertson/devcontainers monorepo, at dvt/. Clone that repo and run the commands below from dvt/.

The pixi default environment (what pixi run uses) carries pytest and hypothesis for the dev loop. A separate runtime environment (pixi run -e runtime ...) has none of that test tooling, for anyone who wants to confirm the package installs cleanly without it — actual distribution to end users is via pipx install, not pixi, so this is a verification aid rather than the real install path.

pixi install
pixi run pytest

Tasks

Each task below is a pixi run wrapper script; the ones with sub-commands dispatch on the first extra argument (e.g. pixi run test unit), so pixi run <task> alone isn't a valid invocation for those. pixi <task> (without run) never works — pixi requires the run verb to invoke a task.