Automatically track your code changes and generate AI-powered changelogs — right inside VS Code. Powered by Google Gemini.
Features
| Feature | Description |
|---|---|
| AI Changelogs | Gemini analyses your diff and writes structured markdown with per-file summaries, breaking-change flags, and architecture notes |
| Live Sidebar | Activity bar panel shows monitoring status, pending-change count, and full version history |
| Smart Model Fallback | Automatically cycles: gemini-2.5-flash-lite → gemini-2.5-flash → gemini-2.5-pro if a model is overloaded |
| Versioned Files | Every sync writes a dated .md to .syncdocs/changelog/ — commit for a permanent audit trail |
| File Watcher | Real-time background tracking detects changes the moment you save |
| Dashboard Panel | Two-pane editor view: version history sidebar + colour-coded detail view |
Getting Started
1. Install SyncDocs
Open VS Code → Extensions (Ctrl+Shift+X) → search SyncDocs → Install
2. Get a free Gemini API key
Google AI Studio — free tier, no billing required.
3. Set your API key
Run Ctrl+Shift+P → SyncDocs: Set Gemini API Key and paste your key.
4. Sync
Click Sync Now in the SyncDocs sidebar, or run Ctrl+Shift+P → SyncDocs: Sync & Generate Change Doc.
Output Structure
your-project/
└── .syncdocs/
└── changelog/
├── v1-2026-06-23.md
├── v2-2026-06-24.md
└── v3-2026-06-25.md
Each changelog contains:
- Summary — one-paragraph AI overview of what changed
- Added / Modified / Deleted — per-file cards with AI descriptions
- Breaking Changes — flagged automatically
Configuration
| Setting | Default | Description |
|---|---|---|
syncdocs.geminiApiKey |
"" |
Your Gemini API key |
syncdocs.outputDir |
.syncdocs |
Output folder name |
syncdocs.ignorePatterns |
["node_modules", ".git", ...] |
Patterns to ignore |
syncdocs.autoTrack |
true |
Watch files in background |
Commands
| Command | Description |
|---|---|
SyncDocs: Sync & Generate Change Doc |
Sync and generate AI changelog |
SyncDocs: Open Dashboard |
Open the visual change history panel |
SyncDocs: Set Gemini API Key |
Save your Gemini API key |
SyncDocs: Reset Project |
Clear baseline and start fresh |
AI Models
SyncDocs tries the fastest model first and automatically escalates if overloaded:
gemini-2.5-flash-lite— default, lowest latency, free tiergemini-2.5-flash— fallback 1, stronger reasoninggemini-2.5-pro— fallback 2, maximum quality
Privacy
Your API key is stored in VS Code's encrypted global secrets storage. No telemetry, no backend servers — only direct calls from your machine to Google's Gemini API.
License
MIT