⚡ AutoRepoSync

Automatically keep your local Git repositories synchronized with their remote GitHub repositories — zero prompts, zero hassle.

🎯 What It Does

AutoRepoSync runs silently in the background and:

1. Periodically fetches remote changes (git fetch)
2. Detects when your branch is behind remote
3. Automatically pulls updates (git pull --rebase --autostash)
4. Stashes your local changes safely before pulling
5. Detects merge conflicts and shows them in a real-time dashboard
6. Supports multiple repositories in the same workspace

You never have to remember to pull again.

✨ Features

📸 Dashboard

Open via Command Palette → AutoRepoSync: Open Dashboard

The dashboard shows:

• Repository list with branch, behind/ahead counts, last sync time
• Green = synced · Yellow = pulling · Red = conflict
• Buttons: Sync Now, Pause, Resume, Open Repo, View Logs
• Live activity log

🚀 Getting Started

Install from Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for AutoRepoSync
4. Click Install

Install from VSIX

code --install-extension autoreposync-1.0.0.vsix

Requirements

• Git must be installed and available on your PATH
• VS Code ≥ 1.85.0

⚙️ Configuration

All settings live under the autosync.* namespace in VS Code Settings.

🎮 Commands

📡 Webhook Mode (Advanced)

For instant sync on push, enable the webhook server:

1. Set autosync.enableWebhookMode to true
2. Configure autosync.webhookPort (default 9090)
3. In your GitHub repo → Settings → Webhooks:
   • Payload URL: http://<your-ip>:9090/webhook
   • Content type: application/json
   • Events: Just the push event
4. The extension will instantly sync when a push is received

Note: The webhook server listens on all interfaces. Use a reverse proxy or firewall in production.

🏗️ Architecture

src/
├── extension.ts          ← Entry point, wires everything
├── gitManager.ts         ← Low-level Git CLI wrapper
├── syncService.ts        ← Periodic sync orchestrator
├── repoWatcher.ts        ← Workspace repo discovery
├── webhookServer.ts      ← Optional HTTP webhook server
├── dashboard/
│   ├── dashboard.ts      ← Webview panel controller
│   ├── dashboard.html    ← Dashboard markup
│   ├── dashboard.css     ← Dashboard styles
│   └── dashboard.js      ← Dashboard client logic
└── utils/
    ├── logger.ts         ← Dual-output logger
    └── settings.ts       ← Typed config reader

Sync Engine Flow

┌──────────┐     ┌──────────┐     ┌──────────┐
│  Timer / │────▶│  Fetch   │────▶│ Compare  │
│  Webhook │     │  Remote  │     │ Local vs │
└──────────┘     └──────────┘     │  Remote  │
                                  └────┬─────┘
                                       │
                          ┌────────────┼────────────┐
                          ▼            ▼            ▼
                      Up to date   Behind       Conflict
                      (no-op)      Pull+Rebase  Notify user

🛠️ Development

Build from source

git clone https://github.com/autoreposync/autoreposync.git
cd autoreposync
npm install
npm run compile

Run in VS Code

1. Open the autoreposync folder in VS Code
2. Press F5 to launch the Extension Development Host
3. The extension activates in any workspace with a .git directory

Package

npm install -g @vscode/vsce
vsce package

This produces autoreposync-1.0.0.vsix.

Publish

vsce publish

📋 Changelog

See CHANGELOG.md.

📄 License

MIT © AutoRepoSync Contributors