Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (geeto) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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, GitHub 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 -s -- --no-label

Requirements: Git ≥ 2.0

Uninstall

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

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 -u, --undo`	Undo the last git action safely
`geeto -st, --stats`	Repository statistics dashboard

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 -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.