Script Reference¶
Vergil-tooling provides Python CLI tools installed as vrg-* 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. For how the
package itself is laid out, see Package Architecture.
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-reword | Reword a branch-local commit message (agent-safe) |
| vrg-whoami | Print the resolved identity role or platform |
| vrg-hook-guard | Claude Code hook that blocks raw git and gh |
| vrg-resolve-tracking-issue | Print a merge commit's tracking issue |
| vrg-vm | Manage the identity agent VMs |
| vrg-submit-pr | Standards-compliant PR submission wrapper |
| vrg-release | Run the full release workflow, ending with the dependency update |
| vrg-update-deps | Update dependencies within their declared bounds and merge the result |
| vrg-finalize-pr | Merge a PR and run post-merge cleanup |
| vrg-ensure-label | Ensure GitHub labels exist |
| vrg-github-repo-config | Audit/reconcile a repo against canonical config |
| vrg-dependabot-audit | Fail on any open Dependabot alert |
| vrg-github-repo-init | Bootstrap a new managed repository |
| vrg-container-run | Run commands inside a dev container |
| vrg-container-test | Run test suite inside a dev container |
| vrg-container-docs | Preview/build MkDocs in a dev container |
| vrg-container-build-command | Print the declared [container].build-command (CI consumption) |
| vrg-container-system-packages | Print the declared [container].system-packages (CI consumption) |
| vrg-container-cache | Manage the per-branch cached dev image |
| vrg-generate-commands | Generate MQSC command methods |
| vrg-host | Report, upgrade and pin the macOS host dependencies |
Container tools¶
Run inside dev containers launched by vrg-container-run.
| Tool | Purpose |
|---|---|
| vrg-validate | Unified validation driver (common + language-specific checks) |
| vrg-repo-profile | Repository profile attribute validation |
| vrg-package | Build, install-test and index binary OS packages from [package] |
| vrg-sarif-filter | Drop accepted-suppressed results from a SARIF file before upload |
| Markdown validation | Markdownlint with bundled canonical config |
Claude Code Hooks¶
| Hook | Purpose |
|---|---|
| Claude Code Hook Guard | PreToolUse guard that blocks raw git and gh; also documents the vrg-commit branch checks |