commit

Create one AI-generated Conventional Commit in each changed repository.

Usagegit-wrangler commit [options]

Warning: This command sends a redacted summary of staged changes to your configured AI service. Git Wrangler shows what will be sent and asks before making the request.

Quick start

git-wrangler commit

What it does

commit finds repositories with changes, asks the configured AI service for Conventional Commit messages, and creates one commit in each changed repository.

No commits are created if Git Wrangler cannot prepare every requested message. Repositories without changes are skipped.

Before you run it

Set up an AI provider, model, and API key with init or config.

Git Wrangler sends file names, change counts, and redacted diff excerpts. It hides sensitive files, common secret values, generated files, dependencies, caches, and build output. Coauthor identities supplied with --coauthor stay local.

Common options

Option Default What it does
--repo <path> Whole workspace Commit changes in exactly one repository.
--body Off Generate a message body in addition to the subject.
--coauthor "Name <email>" — Add a coauthor locally. Repeat for more coauthors.
--yes, -y Off Skip the confirmation before sending data.
--guided Off Choose options through prompts.

Coauthor values must include both a name and email. Repeating the same email in one command is rejected, even if the letter casing differs.

Advanced options

Option Default What it does
--rpm <number> 300 Limit how quickly AI requests start.
--concurrency <number> 8 Limit simultaneous AI requests, from 1 to 64.
--timeout <seconds> 90 Set the timeout for each AI request.

More examples

# Generate subjects and explanatory bodies
git-wrangler commit --body

# Add local coauthors
git-wrangler commit \
  --coauthor "Jane Doe <jane@example.com>" \
  --coauthor "Alex Smith <alex@example.com>"

# Commit one repository
git-wrangler commit --repo ./api
  • Use review to inspect committed work before pushing.
  • Use push to publish the commits.
  • Use rewrite-commits to improve existing commit messages.