Auto Increase Git Version
An intelligent version incrementing extension for Git commit messages in VS Code.
It supports flexible formatting, multiple version segments, and seamless integration with both the commit message box and the clipboard.
📺 Demo
Here’s how it looks in action:

If you prefer a quick static reference:

🚀 How to Use
Quick Start (Default Usage)
- Open the Source Control view in VS Code (so the commit message box is visible).
- Press
Ctrl+Alt+V
(Windows/Linux) or Cmd+Alt+V
(Mac).
- The extension:
- Looks at your last commit version number,
- Automatically increments the last segment (e.g.,
v5 → v6
or v1.2.3 → v1.2.4
depending on the version format in your last commit),
- Inserts the new version into the commit message box,
- Also copies it to your clipboard (if enabled in settings).
👉 You don’t need to focus on new version number anymore, just write your version notes — if the commit message box is open, it will insert the version automatically.
🔢 Advanced Version Increments
Besides the default shortcut (Ctrl+Alt+V
), you can directly bump specific version segments:
Shortcut |
Action |
Example |
Ctrl+Alt+1 |
Increment Major version |
v1.2.3 → v2.0.0 |
Ctrl+Alt+2 |
Increment Minor version |
v1.2.3 → v1.3.0 |
Ctrl+Alt+3 |
Increment Patch version |
v1.2.3 → v1.2.4 |
Ctrl+Alt+4 |
Increment Build version (4th seg) |
v1.2.3 → v1.2.3.1 |
This makes it easy to apply Semantic Versioning (SemVer) principles or use custom build increments.
More Examples:
Current |
Shortcut |
New |
Info |
v1.2.3.4 |
Ctrl+Alt+V |
v1.2.3.5 |
Increment last segment |
v1 |
Ctrl+Alt+V |
v2 |
Increment last segment |
v1.2 |
Ctrl+Alt+V |
v1.3 |
Increment last segment |
----------------------------------------------------------------- |
|
|
|
----------------------------------------------------------------- |
|
|
|
v1.2.3 |
Ctrl+Alt+1 |
v2.0.0 |
Increment major version |
v1.2.3 |
Ctrl+Alt+2 |
v1.3.0 |
Increment minor version |
v1.2.3 |
Ctrl+Alt+3 |
v1.2.4 |
Increment patch version |
v1.2.3.4 |
Ctrl+Alt+4 |
v1.2.3.5 |
Increment build version |
----------------------------------------------------------------- |
|
|
|
----------------------------------------------------------------- |
|
|
|
v1.2 |
Ctrl+Alt+3 |
v1.2.1 |
Add patch version |
v1.2 |
Ctrl+Alt+4 |
v1.2.0.1 |
Add build version |
v1 |
Ctrl+Alt+2 |
v1.1 |
Add minor version |
v1 |
Ctrl+Alt+3 |
v1.0.1 |
Add patch version |
v1 |
Ctrl+Alt+4 |
v1.0.0.1 |
Add build version |
v1.2.3 |
Ctrl+Alt+4 |
v1.2.3.1 |
Add build version |
⚙️ Configuration
You can customize how versions are formatted and handled.
Settings are available through both the Settings UI and settings.json
.
1. Version Prefix
Adds a prefix before the version number.
"autoIncreaseGitVersion.prefix": "v"
Examples:
"v"
→ v1.2.3 -
"ver"
→ ver1.2.3 -
"version-"
→ version-1.2.3 -
"release/"
→ release/1.2.3 -
""
(empty) → 1.2.3 -
2. Version Suffix
Adds a suffix after the version number.
"autoIncreaseGitVersion.suffix": " - "
Examples:
" - "
→ v1.2.3 -
" : "
→ v1.2.3 :
" | "
→ v1.2.3 |
" -> "
→ v1.2.3 ->
""
(empty) → v1.2.3
3. Auto Copy to Clipboard
Automatically copies the version string to your clipboard (when commit box is not available).
"autoIncreaseGitVersion.autoCopyToClipboard": true
true
→ Version is written to commit box and copied to clipboard
false
→ Only written to commit box
🎯 Example Configurations
Standard Format
{
"autoIncreaseGitVersion.prefix": "v",
"autoIncreaseGitVersion.suffix": " - ",
"autoIncreaseGitVersion.autoCopyToClipboard": true
}
→ Output: v1.2.3 -
(also copied to clipboard)
Custom Format
{
"autoIncreaseGitVersion.prefix": "release-",
"autoIncreaseGitVersion.suffix": " : ",
"autoIncreaseGitVersion.autoCopyToClipboard": true
}
→ Output: release-1.2.3 :
(also copied to clipboard)
Minimal Format
{
"autoIncreaseGitVersion.prefix": "",
"autoIncreaseGitVersion.suffix": "",
"autoIncreaseGitVersion.autoCopyToClipboard": false
}
→ Output: 1.2.3
❗ Important Notes
- Restart VS Code after changing settings.
- For project-specific configs, add settings to
.vscode/settings.json
.
- For global configs, add them to User
settings.json
.
- Be cautious when using special characters (
/
, -
, _
, etc.) in prefix/suffix.
🆘 Troubleshooting
Problem: Settings not working
✔ Reload the VS Code window
✔ Restart VS Code
✔ Check for typos in settings.json
Problem: Errors with special characters
✔ Avoid regex special characters like .*+?^${}()[]
✔ Use simpler characters instead
📦 Installation
📄 License
MIT License. See LICENSE for details.
✨ Happy coding, and let version numbers take care of themselves!