Git Sync Helper

**Stay in sync with your team. Monitor upstream changes and push with one click.**

Git Sync Helper is a powerful productivity extension for VS Code designed to keep your local development environment perfectly synchronized with your remote repository. It proactively monitors your git status and provides a streamlined "Quick Push" workflow to save you time.

🚀 Key Features

1. 🔍 Proactive Upstream Monitoring

Never work on stale code again. The extension automatically detects if your current branch is behind the remote upstream.

• Status Bar Indicator: A clear warning appears in the status bar (e.g., $(arrow-down) 5 Behind) when you are missing commits.
• Smart Notifications: Receive a toast notification with a direct "Pull" action button to update your branch instantly.

2. ⚡ Quick Push (One-Click Sync)

Simplify your commit-and-push routine into a single click.

• Status Bar Button: A dedicated $(cloud-upload) Quick Push button is always available.
• Automated Workflow:
  1. Stages all changes (git add .).
  2. Commits with a standard message ("Automatic update").
  3. Pushes to the remote branch (git push).
• Safety: Shows success or error messages to ensure you know the state of your code.

📦 Installation

From the Marketplace

1. Open VS Code.
2. Go to the Extensions view (Ctrl+Shift+X).
3. Search for "Git Sync Helper".
4. Click Install.

Manual Installation (.vsix)

1. Download the .vsix file from the Releases page.
2. Open VS Code.
3. Run Extensions: Install from VSIX... from the Command Palette (Ctrl+Shift+P).
4. Select the downloaded file.

📖 Usage

Monitoring Status

Just open a folder with a Git repository.

• If you are up to date, the "Behind" indicator stays hidden.
• If you fall behind, the indicator appears. Click it or use the notification to Pull.

Using Quick Push

1. Make changes to your files.
2. Look at the status bar (bottom left).
3. Click $(cloud-upload) Quick Push.
4. Watch the progress notifications as your code is safely synced.

⚙️ Configuration

You can customize the extension in your VS Code settings (settings.json):

⌨️ Commands

🔧 Requirements

• VS Code 1.74.0 or newer.
• Built-in Git extension enabled (default in VS Code).

📄 License

This project is licensed under the MIT License.

Enjoying Git Sync Helper? Don't forget to rate us on the Marketplace! ⭐⭐⭐⭐⭐