SyncHub is a lightweight, secure synchronization utility for VS Code and Cursor that allows developers to link, manage, and mirror files from remote GitHub repositories directly into local folders. Built specifically for developers who manage shared code, design assets, or configurations across multiple distinct project workspaces.
Key Features
Multi-Project Subscriptions: Manage and track sync configurations for multiple separate projects simultaneously from an organized sidebar tree interface.
Secure Token-Free Authentication: Leverages VS Code's native GitHub authentication provider to securely pull files from both public and private repositories without exposing or managing clear-text personal access tokens.
Workspace Auto-Detection: Automatically detects your active workspace folder during setup to seamlessly pair and map a repository branch to your local directory.
Atomic Transaction Safety: Protects your code with a safe file-system extraction pipeline. SyncHub unzips updates into a hidden directory and creates local roll-back backups before modifying files—ensuring your workspace never becomes corrupted if your network drops.
How to Use SyncHub
1. Linking a Repository
Click on the SyncHub icon on the vertical Activity Bar (sidebar panel).
Click the + (Subscribe to Project) navigation button at the top of the pane.
Authenticate with your GitHub account securely when prompted.
Paste the repository URL (e.g., https://github.com/username/repository).
Choose a remote branch from the dynamic dropdown selection menu.
Choose whether to link it directly to your open workspace folder or pick a specific directory manually.
2. Synchronizing Files
Hover over your subscribed project entry in the sidebar view and click the inline $(sync) (Sync Now) play icon.
SyncHub will cleanly download, parse, and securely update your target directory files.
3. Removing a Subscription
Hover over any project item you no longer wish to track and click the $(trash) (Unsubscribe) trash bin icon to remove it instantly.
Requirements & Extensions
No third-party command-line utilities or local git installations are required. All file comparisons, downloads, and directory management are handled natively via the extension context background host.
Extension Settings
This extension contributes the following global context features:
synchubProjectsView: Active tree-view structural container listing active project mappings.
synchub.addProject: Command palette function to initiate a registration workflow.
synchub.syncProject: Command execution protocol to sync files.
synchub.removeProject: Command to remove tracked projects.
Release Notes
1.0.0 (Beta)
Initial MVP release.
Implementation of the custom sidebar tree interface dashboard.
Native integration with the official VS Code GitHub authorization engine for private repo access.
Safe transactional file execution with recovery rollbacks.
