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
mainormaster— this is a safety default, not a bug. See Configuration to change it once you're comfortable, or useautopilot preset solo-speedif 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
Installation
Detailed installation guides for all platforms.
Configuration
Customize debounce timers, ignored files, and more.
CLI Reference
Full list of commands and flags.
Troubleshooting
Common issues and how to resolve them.
Advanced Usage
CI/CD, team workflows, monorepos, hooks, and scaling tips.
Roadmap
What’s next, how to contribute, and features under exploration.
Security
Secret scanning, commit signing, and GitHub Actions guidance.
Benchmarks
How to compare Autopilot fairly against other commit tools.
Localization
Guidance for translations and global adoption.
Accessibility
Keyboard-first usage and assistive workflow guidance.
Extensibility
Current extension points and roadmap ideas for plugins.