Script Reference

Vergil-tooling provides Python CLI tools installed as st-* console scripts, plus git hooks. For the full audit of every tool's runtime preconditions, host-vs-container classification, and failure modes, see the CLI Tools Overview.

Host tools

Run on the developer's machine. Installed via uv tool install or the dev-tree override venv.

Tool	Purpose
vrg-commit	Standards-compliant commit wrapper
vrg-submit-pr	Standards-compliant PR submission wrapper
vrg-merge-when-green	Poll PR checks, then merge
vrg-prepare-release	Automated release preparation
vrg-finalize-repo	Post-merge repository cleanup
vrg-ensure-label	Ensure GitHub labels exist
vrg-docker-run	Run commands inside a dev container
vrg-docker-test	Run test suite inside a dev container
vrg-docker-docs	Preview/build MkDocs in a dev container
vrg-generate-commands	Generate MQSC command methods

Container tools

Run inside dev containers launched by vrg-docker-run.

Tool	Purpose
vrg-validate	Unified validation driver (common + language-specific checks)
vrg-repo-profile	Repository profile attribute validation
Markdown validation	Markdownlint with bundled canonical config

CI-only tools

Tool	Purpose
vrg-pr-issue-linkage	PR body issue linkage validation

Git Hooks

Hook	Purpose
pre-commit	Env-var gate (admits vrg-commit, rejects raw git commit)