ZeroDrop 🚀
ZeroDrop ensures you never drop a single line of code. It automatically detects uncommitted changes when you close Visual Studio Code, stages them, commits them, and optionally pushes them to your remote repository.
Features
- Automated Lifecycle: Works silently in the background when the editor shuts down.
- Strict Repo Safety: Built-in protection that guides you if no Git repository is detected.
- Theme-Aware UI: Premium glassmorphic design that matches every VS Code theme (Dark, Light, High Contrast).
- Intelligent Commits: Generates "Conventional Commit" style messages using Groq, Gemini, Ollama, Hugging Face, Cohere, xAI, Moonshot, and MiniMax.
- Interactive Branding: One-click navigation to Company (Hope3) and Developer (Siranjeevan) portals directly from the header.
- Per-Project Branches: Save different target branches for each repository using workspace settings.
- Fetch & Pull Control: Synchronize with remote automatically on startup.
- Zero Credential Handling: Uses your system's existing Git configuration and credentials.
Installation
- Open the Editor.
- Go to the Extensions view (
Ctrl+Shift+X).
- Search for ZeroDrop.
- Click Install.
Configuration
ZeroDrop provides the following settings:
| Setting |
Type |
Default |
Description |
zeroDrop.enableAutoPush |
Boolean |
false |
Whether to push changes to the remote branch on shutdown. |
zeroDrop.commitMessage |
String |
"ZeroDrop: commit message for all things" |
The message used for automatic commits. |
zeroDrop.enableAICommitMessage |
Boolean |
true |
Use AI to generate smart commit messages. |
zeroDrop.aiProvider |
Enum |
"groq" |
Cloud AI Providers: groq, google, huggingface, cohere, xai, etc. |
zeroDrop.apiKey |
String |
"" |
API Key for your chosen cloud provider. |
zeroDrop.ollamaModel |
String |
"llama-3.1-8b-instant" |
The model selection for your provider. |
zeroDrop.preferredBranch |
String |
"main" |
Target branch (Workspace specific). |
zeroDrop.enableAutoInterval |
Boolean |
false |
Enable automatic commits at regular intervals. |
zeroDrop.intervalMinutes |
Number |
30 |
How often (in minutes) to auto-commit and push. |
zeroDrop.fixDefaultCommitsOnStartup |
Boolean |
true |
Replace default commit messages with AI-generated ones when the editor opens. |
To edit these, open your settings.json or use the Settings UI (Cmd+,).
How it Works
On the IDE Close:
- Shutdown Detection: When you close the editor, the extension triggers the
deactivate hook.
- Workspace Scan: ZeroDrop scans all open workspace folders.
- Change Detection: It checks for any modified or untracked files using
git status --porcelain.
- Action:
- If changes are found, it runs
git add . and git commit -m "...".
- If
enableAutoPush is true, it runs git push in the background (using nohup so it continues after the IDE closes).
- Silence: If anything fails (e.g., merge conflicts, network error), the extension fails silently.
On Editor Open (with AI enabled):
- Checks if the last commit used the default message.
- If so, generates an AI commit message using Ollama.
- Asks if you want to replace the default message.
- Optionally force pushes to update the remote.
Interval Auto-Push:
- While the editor is open, a timer runs every N minutes.
- Checks for uncommitted changes.
- Generates AI commit messages (if enabled).
- Commits and pushes automatically.
- Shows a notification confirming the save.
CLI Usage (Antigravity)
ZeroDrop includes a powerful CLI that works without the IDE.
Installation:
npm install -g zerodrop # If published
# OR locally:
npm link
Commands:
- Manual Save:
zerodrop run
- With Auto-Push:
zerodrop run --auto-push
- Use AI:
zerodrop run --ai
- Fix Last Commit:
zerodrop fix --ai --apply
Options:
--path <path>: Target specific folder (default: current)
--message "...": Custom commit message
--model <model>: Custom Ollama model
AI Commit Messages
ZeroDrop supports both Local Ollama and Cloud AI providers:
Cloud AI (Recommended):
- Select provider (Groq, Gemini, etc.) in settings.
- Add your API Key.
- Enjoy blazing fast, logic-aware commit messages.
Local Ollama:
- Install Ollama:
brew install ollama
- Pull a model:
ollama pull qwen2:0.5b
- Set provider to "ollama" and enjoy free, private AI.
The AI analyzes your code changes and generates messages like:
feat: add user authentication
fix: resolve null pointer in login
chore: update dependencies
Branding & Integration
ZeroDrop is built with a sense of identity. The sidebar header features:
- Hope3 Logo: Quick access to our mission at
www.hope3.org.
- Developer Portal: Direct link to the creator's portfolio (Siranjeevan).
Each logo features custom hover tooltips and interactive spring animations.
Safety & Security
- No Data Collection: ZeroDrop does not track your movements or collect telemetry.
- Local First: All Git operations are executed via your local
git binary.
- Local AI: Ollama runs entirely on your machine - no code is sent to the cloud.
- Permission-Based Push: Auto-push is disabled by default to ensure you have full control.
Developed with ❤️ by the ZeroDrop Team.
| |