Dirt Manager 🚀
Real-time collaboration awareness for Git repositories
Prevent merge conflicts by seeing who's editing files and recent branch activity right in your VS Code editor.
✨ Features
🔴 Live Editing Awareness
- See who is currently editing files with unsaved changes
- Real-time presence detection across your team
- Immediate warnings when multiple people work on the same file
⚠️ Recent Branch Activity
- Shows recent commits on files (last 2 weeks)
- Detects open PRs and branch activity
- Smart filtering to avoid noise from old/merged branches
🎨 Professional Warnings
- Native VS Code styling with theme-aware colors
- Clean, non-intrusive warnings at the top of files
- PR numbers and branch information included
📸 Screenshot
When opening a file, you'll see warnings like:
$(error) Currently edited by Sarah Wilson@feature-branch (PR [#123](https://github.com/ofershap/dirt-manager/issues/123))
$(warning) Recent activity on bugfix-login (PR [#456](https://github.com/ofershap/dirt-manager/issues/456)) by John Doe - 3 days ago
🚀 Getting Started
Zero Configuration
The extension works out of the box with smart defaults:
- Auto-detects your Git user information
- Uses the public Dirt Manager server
- No manual setup required
Team Setup
For full team coverage, have everyone install the extension. The more team members using it, the better the conflict prevention!
⚙️ Configuration
All settings are optional:
dirtManager.apiBaseUrl
: Custom server URL (optional)
dirtManager.readToken
: Read token for private servers (optional)
dirtManager.writeToken
: Write token for private servers (optional)
🔧 How It Works
- Real-time tracking: Extension reports when you save files with changes
- Smart detection: Combines live presence with Git commit history
- Conflict prevention: Warns you before conflicts happen
🛡️ Privacy
- Only tracks files you explicitly save with changes
- Uses hashed user IDs for privacy
- No code content is ever transmitted
🐛 Support & Feedback
Have questions, found a bug, or want to suggest a feature?
📄 License
MIT License - see LICENSE for details.
Enjoy conflict-free coding! 🎉