vrg-commit¶

Installed as: vrg-commit (Python console script)

Source: src/vergil_tooling/commit.py

Wrapper that constructs standards-compliant commit messages with correct Conventional Commits format and Co-Authored-By trailers.

Required for AI agents

AI agents must use this tool instead of raw git commit. The tool resolves the correct co-author identity automatically.

Usage¶

vrg-commit \
  --type TYPE --message MESSAGE --agent AGENT [options]

Arguments¶

Argument	Required	Description
`--type`	Yes	Conventional commit type
`--message`	Yes	Commit description
`--agent`	Yes	AI tool identity: `claude` or `codex`
`--scope`	No	Conventional commit scope
`--body`	No	Detailed commit body

Allowed Types¶

feat, fix, docs, style, refactor, test, chore, ci, build

Examples¶

# Feature with scope
vrg-commit \
  --type feat --scope lint \
  --message "add new check" --agent claude

# Bug fix
vrg-commit \
  --type fix \
  --message "correct regex pattern" --agent claude

# Documentation with body
vrg-commit \
  --type docs --message "update README" \
  --body "Expanded usage section" --agent claude

Behavior¶

Validates all required arguments.
Reads docs/repository-standards.md to find the approved co-author identity matching the --agent value.
Verifies staged changes exist.
Constructs the commit message in a temporary file.
Runs git commit --file.

Exit Codes¶

Code	Meaning
0	Commit created successfully
1	Validation failure or missing identity