A VS Code extension that helps you create and manage code milestones through git commits. This extension provides a seamless way to mark important points in your development process and easily revert to them when needed.
⚠️ IMPORTANT: This extension performs branch alterations and force pushes. It must be used on a dedicated feature branch - DO NOT use on master/main branches.
Features
Milestone Creation: Create named milestones at any point in your development process
Visual Management: Dedicated activity bar view for managing all your milestones
Easy Navigation: Quick access to all milestones through the sidebar
Git Integration: Automatic git commit and tracking for each milestone
Revert Capability: One-click reversion to any previous milestone
Visual Feedback: Clear visual indicators for current and available milestones
Installation
Open Visual Studio Code
Go to the Extensions view (Ctrl+Shift+X)
Search for "Milestone Manager"
Click Install
Reload VS Code when prompted
Requirements
Visual Studio Code ^1.85.0
Git must be installed and configured on your system
Your project must be initialized as a git repository
A dedicated feature branch (NOT master/main) as the extension uses force push operations
Usage
Branch Setup
Create and checkout a dedicated feature branch for milestone management
Never use this extension on master/main branches
Ensure you have force push permissions on your branch
Creating a Milestone
Click the Milestone Manager icon in the activity bar (looks like a milestone flag)
Click the "Create Milestone" button (+ icon) in the Milestones view
Enter a name and optional description for your milestone
⚠️ WARNING: Do not create milestones in folders containing secrets or sensitive files. Any files in git-tracked folders will be committed, which could accidentally expose sensitive information.
The extension will automatically:
Stage all current changes
Create a commit with your milestone information
Tag the commit for future reference
Viewing Milestones
Open the Milestone Manager sidebar (click the milestone flag icon)
Browse through all your created milestones
Each milestone shows:
Milestone name
Creation date
Description (if provided)
Associated git commit
Reverting to a Milestone
Find the desired milestone in the Milestones view
Click the "Revert to Milestone" button
Confirm the reversion
Your code will be restored to the exact state of that milestone
Extension Commands
The extension provides the following commands:
milestone-manager.createMilestone: Create a new milestone
milestone-manager.revertToMilestone: Revert to a selected milestone
Extension Settings
This extension contributes the following settings:
milestone-manager.showStatusBar: Enable/disable the milestone status in the status bar
Best Practices
Create milestones at significant development points:
After implementing major features
Before making significant changes
At stable, tested states of your code
Add descriptive names and notes to your milestones
Git Branch Management:
Always use a dedicated feature branch
Never create milestones on master/main branches (this is automatically blocked by the extension)
Inform team members about force push operations
⚠️ Never create milestones in folders containing secrets or sensitive files - all git-tracked files will be committed
Known Issues
None at the moment.
⚠️ Git Operations Warning: This extension performs force push operations and branch alterations. Make sure you understand the implications and have the necessary permissions.
Release Notes
1.0.1
Fixed bug: Milestones are now isolated to specific branches
Improved milestone tracking with branch-specific commit messages
Enhanced milestone display in the milestones panel
1.0.0
Initial release of Milestone Manager with core features:
Milestone creation and management
Visual milestone browser
Revert functionality
Git integration
Contributing
Found a bug or have a feature request? Please open an issue on our GitHub repository.
