geeto

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 (stable + alpha/beta/rc), CHANGELOG.md, RELEASE.MD, GitHub/GitLab 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 + GitLab — Pull Requests / Merge 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/

Prerelease binary

To install a specific prerelease version (alpha, beta, or rc):

# Replace TAG with the version, e.g. v0.7.0-beta.1
curl -fsSL https://github.com/rust142/geeto/releases/download/TAG/geeto-linux -o geeto
chmod +x geeto
sudo mv geeto /usr/local/bin/

Browse all prereleases at Releases.

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:

• Stage — Select files to commit
• Branch — AI generates a branch name from your changes
• Commit — AI generates a conventional commit message
• Push — Push to remote with progress bar
• Merge — Merge to target branch
• 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 / GitLab

Command	Description
geeto -pr, --pr	Create a Pull Request (GitHub) or Merge Request (GitLab)
geeto -i, --issue	Create an Issue
geeto -t, --tag	Release & tag manager (semver + prerelease, changelog, 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-gitlab	Configure GitLab 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

• Fork the repository
• Create a branch: dev#your-feature
• Make your changes
• Run checks: bun run check:fast && bun run check:full
• 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.