AI-Powered Git Automation & Release Tool
Otto is a powerful CLI that automates your git workflow while keeping everything organized. It uses AI to write conventional commit messages, manages semantic versioning, simplifies branch management, and automatically logs every release to a Google Sheet.
You can run Otto directly without installation:
npx otto-cliOr install it globally for daily use:
npm install -g otto-cli
# or
pnpm add -g otto-cliOnce installed, simply run otto-cli or otto in any git repository to start the interactive menu.
Otto is designed to be zero-friction. When you run it for the first time, it will interactively ask for the necessary credentials and save them securely to your global configuration (~/.otto-cli/config.json).
Required:
- OpenAI API Key: Used to analyze diffs and generate commit messages.
Optional:
- Google Sheets Webhook URL: Used to log release history automatically.
You can modify these settings at any time by running:
otto-cli settingsOr selecting "⚙️ Settings" from the main menu.
Stop writing "fix bug" or "update". Otto analyzes your staged changes using GPT-4o-mini and generates descriptive, conventional commit messages and technical descriptions automatically.
- Automatically suggests user-friendly version bumps (Patch, Minor, Major).
- Supports snapshot/canary releases.
- Creates annotated git tags.
Keep a permanent record of every deployment. Otto sends a structured payload (User, Branch, Version, Commit Message, Technical Description) to your Google Sheet.
- Safe Switch: Automatically stashes changes before switching branches and pops them after.
- Easy PRs: Open a Pull Request for your current branch with one click.
- Cleanup: Delete old local branches easily.
Mistakes happen. Otto provides a clean, visual history of your recent commits and allows you to perform Soft, Mixed, or Hard resets safely with confirmation prompts.
You can use Otto in Interactive Mode (recommended) or via Direct Commands.
Just type otto or otto-cli to enter the interactive dashboard.
| Command | Description |
|---|---|
otto release |
The Core Flow: Build -> AI Commit -> Tag -> Push -> Log |
otto build |
Run install and build scripts from package.json |
otto branch |
Manage branches (Switch, Create, Delete, PR) |
otto stash |
Interactive stash management (Save, Apply, Drop) |
otto undo |
Visual commit history and rollback/reset tool |
otto sync |
Fetch and Pull changes with one command |
otto settings |
View or update API keys and configurations |
To enable the automatic changelog/release logger, follow these steps to deploy a simple Webhook.
Go to sheets.new and create a blank spreadsheet.
Click Extensions > Apps Script in the top menu. Remove any existing code and paste this:
function doPost(e) {
const sheet = SpreadsheetApp.getActiveSheet();
const data = JSON.parse(e.postData.contents);
// Appends: Timestamp | User | Branch | Type | Message | Description
sheet.appendRow([
new Date(),
data.user,
data.branch,
data.type,
data.message,
data.description,
]);
return ContentService.createTextOutput(
JSON.stringify({ status: "success" }),
).setMimeType(ContentService.MimeType.JSON);
}- Click the blue Deploy button > New deployment.
- Click the gear icon next to "Select type" and choose Web app.
- Description:
Otto Logger - Execute as: Me
- Who has access: Anyone (Important! This allows the CLI to send data without OAuth complexity).
- Click Deploy.
Copy the Web app URL (it starts with https://script.google.com/...).
Run otto settings and paste the URL when prompted.
Most release tools are just scripts. Otto is an intelligent assistant.
- It doesn't just bump versions; it documents why the version changed.
- It doesn't just checkout branches; it protects your work-in-progress.
- It doesn't just run builds; it ensures you're synced with remote first.
- Node.js 18.0.0 or higher
- Git