Introduction

An intelligent Git automation CLI that safely commits and pushes your code so you can focus on building.


What is Autopilot?

Autopilot CLI is an intelligent Git automation tool that safely commits and pushes your code so you can focus on building. It runs quietly in the background, watching your project files and handling Git operations for you — batching related changes, writing conventional commit messages, and syncing with your remote, all without interrupting your flow.

Most AI commit tools ask you to run a command every time you want a message written. Autopilot doesn't wait to be asked — it's the difference between a tool you operate and a tool that just takes care of things.

What's New in v4.0.2

  • Free Model Defaults — Autopilot now prefers free OpenRouter models and rotates through them automatically when one is unavailable.
  • Automatic Leaderboard Sync — sync focus metrics while the watcher runs, with a built-in offline-safe escape hatch.
  • Branch Rules — define branch-specific blocking, signing, and push policies with wildcard patterns.
  • Safety Net — undo accidental commits instantly with autopilot undo, plus commit signing and offline mode for stricter workflows.

It's designed for:

  • 🚀 Solo developers who want to focus on coding, not committing.
  • 🌱 Beginners who are still learning Git and want safe defaults instead of a learning curve.
  • 👥 Teams who want to standardize commit quality and enforce safety checks.
  • 🛡️ Safety-conscious users who never want to lose work.
  • Rapid prototyping, where speed matters more than granular commit history.

Requirements

  • Node.js 18 or later
  • Git installed and available on your PATH
  • Works on Windows, macOS, and Linux

Quick Install

Install Autopilot globally using npm:

npm install -g @traisetech/autopilot

60-Second Quick Start

Follow these four commands to get up and running:

1. Initialize

Navigate to your project root and generate the configuration file. If you're starting from an empty folder, Autopilot will offer to set up Git for you too.

autopilot init

2. Start watching

Start the background daemon. Autopilot will now monitor your files and sync changes automatically.

autopilot start

Heads up: by default, Autopilot won't push directly to main or master — this is a safety default, not a bug. See Configuration to change it once you're comfortable, or use autopilot preset solo-speed if you'd rather move fast on a personal project.

3. Check status

Verify that the watcher is running and see recent activity:

autopilot status

4. Stop

When you're done for the day, or need to switch branches manually:

autopilot stop

Explore Documentation

Was this page helpful?
Edit this page