# Source: https://docs.windsurf.com/windsurf/ai-commit-message.md

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Commit Messages

> Generate meaningful git commit messages automatically with AI by analyzing your code changes with a single click in Windsurf.

Generate git commit messages with a single click. This feature analyzes your code changes and creates meaningful commit messages that describe what you've done.

Available with no limits to all paid users!

<Frame>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=99e873d7ec0f7929281ddfa1550d9e36" data-og-width="2066" width="2066" data-og-height="888" height="888" data-path="assets/windsurf/ai-commit-message.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=280&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=07ddbe3f3baa2097432efbbe9f671823 280w, https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=560&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=7490934c801292c0ad7e0e7167be456e 560w, https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=840&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=7fe66ddc711541b11c1a9172cf04fea1 840w, https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=1100&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=8d0f2934011712b96e09038e02f8b870 1100w, https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=1650&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=9856a56cb713d1368110d8b57057eafa 1650w, https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/ai-commit-message.png?w=2500&fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=1805071f771905484c76bb0a42974994 2500w" />
</Frame>

# How It Works

When you're ready to commit changes:

1. Stage your files in the Git panel
2. Click the sparkle (✨) icon next to the commit message field
3. Review the generated message and edit if needed
4. Complete your commit

The AI analyzes your recent code changes and creates a meaningful commit message that describes what you've done.

# Best Practices

For better results:

* Apply general best practices for commit scope: group together small, meaningful units of changes
* Review the message before committing

# Limitations

* Large or complex commits may result in more generic messages
* Specialized terminology might not always be captured perfectly
* Generated messages are suggestions and may need editing

# Privacy

Your code and commit messages remain private. We don't store your code changes or use them for training our models.