GitPilot

Air Traffic Control for Git Pushes.

GitPilot is a command-line tool designed to prevent push collisions in shared branch workflows. It introduces structured coordination for teams working on the same branch — without changing your Git workflow.

Why GitPilot?

In shared branch workflows (e.g., develop, staging), multiple developers may push simultaneously.

This often results in:

• Late-stage merge conflicts
• Interrupted rebases
• Lost development time
• Unclear visibility into active pushers

GitPilot adds lightweight coordination so teams can push with clarity and confidence.

How It Works

GitPilot provides a simple runway system:

• One active pusher per branch
• Early conflict visibility at filename level
• Automatic lock expiry
• Simple CLI workflow

No additional server setup required. GitPilot connects to the official coordination server automatically.

Installation

Install globally:

npm install -g gitpilot-cli

Usage

Request Push Clearance

gitpilot hop

Automatically detects:

• Current branch
• Modified files
• Current system user

Check Branch Status

gitpilot who --branch develop

Release Runway

gitpilot land

Configuration

GitPilot connects to the official GitPilot coordination server by default.

If you prefer to run your own coordination server, override the endpoint using an environment variable.

Windows:

set SERVER_URL=https://your-custom-server.com/api

Mac/Linux:

SERVER_URL=https://your-custom-server.com/api

Feedback

GitPilot is currently in early release. Feedback and real-world usage insights are highly appreciated.

Author

Rathakrishnan Kokilan