Auto Git Sync

Automatically commits and pushes document changes to GitHub in real-time.

Features

• Automatic Sync: Every document change is automatically committed and pushed to your configured GitHub repository
• New Document Support: Handles untitled documents by creating files with timestamps
• Auto Repository Creation: Automatically creates and configures a sync repository on first run
• Custom Repository Path: Set your own path for the sync repository
• Debounced Commits: Waits 5 seconds after the last change before committing
• Status Bar Integration: Shows sync status with visual indicators
• Toggle Control: Enable/disable auto-sync functionality

Setup

First Time Setup (Recommended)

1. Install the extension
2. When prompted, choose "Create Repository"
3. Set your preferred repository path (default: ~/Documents/vscode-auto-sync)
4. Enter your GitHub repository URL (e.g., https://github.com/yourusername/your-repo.git)
5. Make sure you have git credentials configured for pushing

Manual Setup

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run Auto Git Sync: Create New Sync Repository or Auto Git Sync: Configure Repository
3. Follow the prompts to set up your repository

Settings

• autoGitSync.repositoryUrl: GitHub repository URL
• autoGitSync.repositoryPath: Custom path for the sync repository (leave empty for default)
• autoGitSync.enabled: Enable/disable auto sync (default: true)
• autoGitSync.debounceTime: Time to wait after last change before committing in milliseconds (default: 5000)
• autoGitSync.organizeByType: Organize files into folders by file type (default: true)

Commands

• Auto Git Sync: Create New Sync Repository: Create and configure a new sync repository
• Auto Git Sync: Configure Repository: Set up your GitHub repository URL
• Auto Git Sync: Set Repository Path: Change the local repository path
• Auto Git Sync: Toggle Auto Sync: Enable/disable the extension

How it Works

1. Repository Creation: Extension creates a local git repository at your specified path
2. Document Tracking: All document changes (including untitled files) are tracked
3. Auto Commit: After 5 seconds of inactivity, changes are committed with timestamps
4. Auto Push: Commits are automatically pushed to your GitHub repository
5. File Handling:
   • Smart Naming: Untitled documents use intelligent naming based on content or language
   • Multiple Files: Each open file is saved separately with its original name/title
   • Unique Names: Automatic handling of filename conflicts with incremental counters
   • File Organization: Files are organized into folders by type (JavaScript, Python, Documents, etc.)
   • Proper Extensions: Automatic extension detection based on language mode
   • All Changes Preserved: Complete history with descriptive commit messages

Requirements

• Git must be installed and configured with push access to your repository
• GitHub repository with appropriate permissions
• Network connection for pushing changes

Note

This extension creates commits for every change. Use with repositories specifically intended for tracking document changes, not production code repositories.