Geeto

AI-Powered Git Workflow Automation

Geeto automates your entire Git workflow — from staging to cleanup — with AI-powered branch naming, commit messages, release management, and Trello integration. Supports Gemini, Copilot, and OpenRouter.

Highlights

• AI-Powered — Branch names, commit messages, and release notes generated by Gemini, Copilot, or OpenRouter
• Full Git Workflow — Stage → Branch → Commit → Push → Merge → Cleanup in one command
• Release Manager — Semver bumping, CHANGELOG.md, RELEASE.MD, GitHub Releases, tag recovery
• Inline Editor — Built-in terminal editor with syntax highlighting (no vim needed)
• Trello Integration — Link branches to cards, generate AI agent task lists
• GitHub Integration — Pull Requests, Issues, repo settings, all from the terminal
• Git Toolkit — Branch cleanup, switcher, compare, cherry-pick, stash, amend, undo, stats, history
• Checkpoint Recovery — Resume interrupted workflows from any step
• Cross-Platform — macOS, Linux, Windows

Installation

Homebrew (macOS / Linux)

brew tap rust142/geeto
brew install geeto

APT (Debian / Ubuntu)

curl -fsSL "https://github.com/rust142/geeto/releases/latest/download/geeto_$(curl -s https://api.github.com/repos/rust142/geeto/releases/latest | grep tag_name | cut -d '"' -f4 | tr -d v)_amd64.deb" -o geeto.deb
sudo dpkg -i geeto.deb
rm geeto.deb

NPM / Bun

npm install -g geeto
# or
bun install -g geeto

Binary (manual)

Download from Releases:

| Platform | Binary | | ----------- | ------------------- | | macOS x64 | geeto-mac | | macOS ARM | geeto-mac-arm64 | | Linux x64 | geeto-linux | | Linux ARM | geeto-linux-arm64 | | Windows x64 | geeto-windows.exe |

curl -fsSL https://github.com/rust142/geeto/releases/latest/download/geeto-linux -o geeto
chmod +x geeto
sudo mv geeto /usr/local/bin/

From Source

curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/install.sh | bash

The installer shows step-by-step progress, detects existing installs, and verifies the installation.

Prerequisites (depends on install method):

• Homebrew / APT / Binary — just Git ≥ 2.0 (runtime is bundled)
• NPM — Node.js ≥ 18 + Git ≥ 2.0
• Bun / From Source — Bun ≥ 1.0 + Git ≥ 2.0

Uninstall

Choose one method based on how you installed:

| Method | Command | | -------- | -------------------------------------------------------------------------------------------- | | Homebrew | brew uninstall geeto && brew untap rust142/geeto | | APT | sudo dpkg -r geeto | | NPM/Bun | npm uninstall -g geeto | | Binary | sudo rm /usr/local/bin/geeto | | Source | curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/uninstall.sh \| bash |

The uninstall script supports flags:

• --force — skip confirmation prompt
• --purge — also remove config directory (~/.geeto/)

Update

Choose one method based on how you installed:

| Method | Command | | -------- | ----------------------------------------------------------------------------------------- | | Homebrew | brew update && brew upgrade geeto | | APT | Re-download the latest .deb from Releases and run sudo dpkg -i geeto.deb | | NPM/Bun | npm update -g geeto | | Binary | Download the latest binary from Releases | | Source | curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/update.sh \| bash |

The update script auto-detects your install method and guides you to the right upgrade path.

Quick Start

geeto

▶ Watch demo on asciinema

On first run, Geeto guides you through AI provider setup:

| Provider | Setup | | -------------- | ------------------------------------------------------------------------------- | | Gemini | Enter API key from Google AI Studio | | OpenRouter | Enter API key from OpenRouter | | Copilot | Auto-configured via GitHub CLI |

All config is saved locally in .geeto/.

How It Works

Geeto walks you through 6 steps in sequence:

1. Stage — Select files to commit
2. Branch — AI generates a branch name from your changes
3. Commit — AI generates a conventional commit message
4. Push — Push to remote with progress bar
5. Merge — Merge to target branch
6. Cleanup — Delete merged branches

Each step can also be run individually.

CLI Reference

Workflow

| Command | Description | | -------------------- | ------------------------------- | | geeto | Full workflow (all 6 steps) | | geeto -s, --stage | Stage files interactively | | geeto -sa, -as | Stage all changes automatically | | geeto -c, --commit | Create commit with AI message | | geeto -b, --branch | Create branch with AI name | | geeto -p, --push | Push current branch to remote | | geeto -m, --merge | Merge branches interactively |

Git Tools

| Command | Description | | -------------------------- | ----------------------------------- | | geeto -cl, --cleanup | Clean up local & remote branches | | geeto -sw, --switch | Switch branches with fuzzy search | | geeto -cmp, --compare | Compare current branch with another | | geeto -cp, --cherry-pick | Cherry-pick from another branch | | geeto -lg, --log | View commit history with timeline | | geeto -sh, --stash | Manage stashes interactively | | geeto -am, --amend | Amend the last commit | | geeto -rw, --reword | Edit past commit messages | | geeto -u, --undo | Undo the last git action safely | | geeto -rv, --revert | Revert the last commit (soft reset) | | geeto -al, --alias | Install shell aliases for geeto | | geeto -sts, --stats | Repository statistics dashboard | | geeto -st, --status | Pretty git status overview | | geeto -pl, --pull | Pull from remote interactively | | geeto -ft, --fetch | Fetch latest from remote | | geeto --abort | Abort in-progress operation | | geeto --prune | Remove stale remote branches |

GitHub

| Command | Description | | ------------------- | ---------------------------------------------------------- | | geeto -pr, --pr | Create a Pull Request | | geeto -i, --issue | Create an Issue | | geeto -t, --tag | Release & tag manager (semver, changelog, GitHub Releases) | | geeto -rp, --repo | Update repo description, topics & homepage (AI-powered) |

Trello

| Command | Description | | ------------------------------ | --------------------------- | | geeto -tr, --trello | Open Trello menu | | geeto -tl, --trello-list | List boards and lists | | geeto -tg, --trello-generate | Generate AI agent task list |

Settings

| Command | Description | | -------------------------- | ---------------------------- | | geeto --setup-gemini | Configure Gemini AI | | geeto --setup-openrouter | Configure OpenRouter AI | | geeto --setup-github | Configure GitHub token | | geeto --setup-trello | Configure Trello integration | | geeto --change-model | Switch AI provider / model | | geeto --sync-models | Fetch latest model list | | geeto --separator | Set branch name separator |

Editor & Options

| Command | Description | | ---------------------- | --------------------------------------------------- | | geeto <file> | Open file in inline editor with syntax highlighting | | geeto -f, --fresh | Start fresh (ignore checkpoint) | | geeto -r, --resume | Resume from last checkpoint | | geeto -dr, --dry-run | Simulate commands without executing | | geeto -v, --version | Show version | | geeto -h, --help | Show help |

Trello Integration

Generate task instruction files for AI coding agents:

geeto --trello-generate

Creates .github/instructions/tasks.instructions.md with structured task lists from your Trello cards — including step-by-step instructions, implementation checklists, and per-task confirmation flows.

Development

git clone https://github.com/rust142/geeto.git
cd geeto
bun install

bun run build          # Build
bun run dev            # Development mode (run from source)
bun run check:fast     # Quick lint
bun run check:full     # Full typecheck + lint

See CONTRIBUTING.md for detailed guidelines.

Contributing

1. Fork the repository
2. Create a branch: dev#your-feature
3. Make your changes
4. Run checks: bun run check:fast && bun run check:full
5. Submit a Pull Request to develop branch

See CONTRIBUTING.md for details.

Support

If Geeto helps your workflow, consider supporting:

• ☕ Buy me a coffee on Saweria
• ⭐ Star this repository
• 🐛 Report bugs or suggest features
• 📢 Share with fellow developers

License

MIT — see LICENSE for details.