UptoDate

UpTo

Prevent outdated pushes with smart branch sync checks before every Git push.

UpTo is a VS Code extension designed to prevent integration conflicts, broken staging environments, and “I forgot to pull” moments in collaborative Git workflows.

Instead of relying on developers to manually check whether their branch is up to date, UpTo automatically verifies tracked branches before a push and warns the developer when they are behind.

Built for fast-moving teams working with:

main staging production release branches shared feature branches ✨ Features ✅ Smart Branch Sync Checks

Before pushing, UpTo checks whether your current branch is behind selected tracked branches.

Example:

Current Branch: feature/payment-refactor Tracked Branches:

• main
• staging

If main or staging has newer commits, UpTo warns the user before allowing the push.

✅ Merge Protection Modal

If your branch is behind:

Your branch is behind 'staging' by 4 commits. Please merge before pushing.

Actions:

Merge Push Anyway Cancel ✅ Per-Developer Tracking

Every developer can choose which branches matter to them.

Examples:

main staging production release/v2 ✅ Works Across Repositories

Install once in VS Code and use across multiple Git repositories.

✅ Lightweight & Fast No external servers No GitHub App required No CI dependency Runs locally using Git 🚀 Why UpTo Exists

Teams often face these issues:

Developers forget to pull latest changes Staging crashes after outdated pushes Hidden merge conflicts appear late Shared environments become unstable Team members unknowingly overwrite each other

UpTo acts as a proactive safety layer between developers and Git pushes.

🧠 How It Works

UpTo performs these steps before a push:

git fetch origin ↓ Compare current branch with tracked branches ↓ Detect missing commits ↓ Show warning modal if behind ↓ Allow merge / cancel / push anyway 📦 Installation From VS Code Marketplace

Coming soon.

Local Development Installation

Clone the repository:

git clone cd upto

Install dependencies:

pnpm install

Run extension in development mode:

F5

This opens a new VS Code Extension Development Host window.

⚙️ Requirements VS Code ^1.119.0 Git installed Node.js >=18

Recommended:

pnpm 🛠 Development Setup Install dependencies pnpm install Start watch mode pnpm run watch Run extension

Press:

F5

inside VS Code.

📁 Project Structure src/ ├── extension.ts ├── git/ │ ├── checker.ts │ └── commands.ts ├── ui/ │ └── pushModal.ts 🧪 Commands UpTo: Secure Push

Safely pushes current branch after sync validation.

UpTo: Track Branches

Configure tracked branches for update validation.

UpTo: Status

Shows current synchronization status against tracked branches.

🔐 Philosophy

UpTo is intentionally designed to:

Warn developers early Reduce broken shared environments Preserve developer autonomy Avoid blocking legitimate workflows

Developers always maintain final control.

🏗 Roadmap Planned Features Terminal git push interception GitHub authentication Team-wide branch policies Auto-merge support Branch health indicators AI-assisted merge conflict explanation Pull request awareness Multi-repository workspace support GitLens integration Team sync dashboard 🤝 Contributing

Contributions are welcome.

Development workflow git checkout -b feature/my-feature pnpm run watch 📄 License

MIT License

👨‍💻 Author

Built by Manish Regmi

⭐ Vision

UpTo aims to become the safety layer modern development teams never realized they needed:

“Know before you push.”