git-std — Usage

git std — standard git workflow from commit to release.

Synopsis

git std <command> [options]

Commands

git std check

Validate commit messages against the Conventional Commits specification.

Input modes:

git std check "feat: add login"                    # inline message
git std check --file .git/COMMIT_EDITMSG           # from file (strips # comments)
git std check --range main..HEAD                   # all commits in a range

Flags:

Exit codes: 0 = valid, 1 = invalid, 2 = I/O or usage error.

Examples:

# Validate a single message
git std check "feat(auth): add OAuth2 PKCE flow"

# Validate all commits on a branch
git std check --range main..HEAD

# Strict mode — reject unknown types and scopes
git std check --strict --range main..HEAD

# As a commit-msg hook
git std check --file "$1"

git std commit

Interactive conventional commit builder. Prompts for type, scope, description, body, and breaking change, then runs git commit.

Flags:

Exit codes: 0 = committed, 1 = validation/git error, 2 = usage error.

git std bump

Calculate the next version from conventional commits, update version files, generate changelog, commit, and tag.

Flags:

Exit codes: 0 = success, 1 = error.

git std changelog

Generate or update the changelog from git history.

Flags:

--full and --range are mutually exclusive. Without either, generates an incremental changelog from unreleased commits since the last tag.

git std hooks

Manage git hooks defined in .githooks/*.hooks files.

git std hooks install    # set up hooks directory and shim scripts
git std hooks run <hook> # execute a hook manually
git std hooks list       # display configured hooks

git std self-update (planned)

Fetch the latest release and replace the current binary. Not yet implemented.

Global Flags

Configuration

git-std reads .git-std.toml in the project root. All fields are optional — sensible defaults are used when the file is absent or a field is omitted.

Full schema

# ── Project ───────────────────────────────────────────────────────
scheme = "semver"                              # semver | calver | patch
types = ["feat", "fix", "docs", "style",
         "refactor", "perf", "test",
         "chore", "ci", "build"]
scopes = ["auth", "api", "ci", "deps"]         # "auto" | string[] | omit
strict = true                         # enforce types/scopes

# ── Versioning ────────────────────────────────────────────────────
[versioning]
tag_prefix = "v"                               # git tag prefix
prerelease_tag = "rc"                          # default pre-release id
calver_format = "YYYY.MM.PATCH"                # only when scheme = "calver"

# ── Changelog ─────────────────────────────────────────────────────
[changelog]
hidden = ["chore", "ci", "build", "style", "test"]

[changelog.sections]
feat = "Features"
fix = "Bug Fixes"
perf = "Performance"
refactor = "Refactoring"
docs = "Documentation"

Fields

Top-level

Default types: feat, fix, docs, style, refactor, perf, test, chore, ci, build.

Scopes behavior:

• Not set (default) — no scope validation, any scope accepted
• scopes = "auto" — discover scopes from workspace layout (crates/*, packages/*, modules/*)
• scopes = ["auth", "api"] — explicit allowlist

When scopes is set (either "auto" or an array) and --strict is used, a scope is required and must be in the resolved list. For git std commit, the resolved scopes populate the interactive scope prompt.

[versioning]

Calendar version format tokens:

Common formats: YYYY.MM.PATCH (monthly releases), YYYY.0M.PATCH (zero-padded month), YY.WW.DP (weekly with day-of-week), YYYY.MM.DD.PATCH (daily releases).

Bump rules are inferred from the scheme — not configurable. For semver: BREAKING CHANGE or ! triggers major, feat triggers minor, everything else triggers patch.

[changelog]

[changelog.sections]

Maps commit types to changelog section headings. Types not listed here use the type name as the heading.

Inferred settings

These are not configurable — git-std resolves them automatically:

Minimal examples

No config needed — git-std works with zero configuration using conventional defaults.

Types and scopes only:

types = ["feat", "fix", "chore"]
scopes = ["auth", "api"]

Calver project:

scheme = "calver"

[versioning]
calver_format = "YYYY.0M.PATCH"

Custom changelog sections:

[changelog]
hidden = ["chore", "ci"]

[changelog.sections]
feat = "New Features"
fix = "Bug Fixes"
perf = "Performance Improvements"

CI Integration

# GitHub Actions
- name: Validate commits
  run: git std check --range ${{ github.event.pull_request.base.sha }}..${{ github.sha }}

# GitLab CI
lint:commits:
  script:
    - git std check --range $CI_MERGE_REQUEST_DIFF_BASE_SHA..HEAD

Hooks Integration

Create .githooks/commit-msg.hooks:

! git std check --file {msg}

Then install:

git std hooks install

Every commit message will be validated automatically.