Getting started

Install

Install script (recommended):

curl -fsSL https://raw.githubusercontent.com/driftsys/git-std/main/install.sh | bash

From source:

cargo install git-std

Shell completions:

# Bash (~/.bashrc)
eval "$(git-std --completions bash)"

# Zsh (~/.zshrc)
eval "$(git-std --completions zsh)"

# Fish (~/.config/fish/config.fish)
git-std --completions fish | source

Set up hooks

git std hook install

This sets core.hooksPath, writes shim scripts, and prompts which hooks to enable. Default: pre-commit and commit-msg.

AI agent skills

Install the std-commit and std-bump skills for your AI coding agent:

npx skills add driftsys/git-std

Make a commit

Stage your changes and run the interactive builder:

git add .
git std commit

Or use non-interactive mode:

git std commit -m "feat(auth): add OAuth2 PKCE flow"

Validate commits

git std lint "feat: add login"
git std lint --range main..HEAD

Use --strict to enforce types and scopes from .git-std.toml.

Preview changelog

git std changelog --stdout

Bump, changelog, and tag

git std bump
git push --follow-tags

This analyses commits since the last tag, calculates the next version, updates version files, generates the changelog, creates a release commit, and tags it.

Use --dry-run to preview without writing anything.