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

Streamline your Git workflow with intelligent branch naming, commit messages, and Trello integration—powered by AI (Gemini, GitHub Copilot, OpenRouter).

Features

Multiple AI Providers — Gemini, GitHub Copilot, OpenRouter
Smart Branch Naming — AI-generated branch names from diffs or Trello cards
Conventional Commits — Auto-generated commit messages following best practices
Inline Editor — Built-in terminal editor with syntax highlighting (no vim needed)
Release Manager — Semver bumping, CHANGELOG.md, RELEASE.MD, and tagging
Trello Integration — Link branches to Trello cards, generate task lists for AI agents
Git Tools — Branch cleanup, switcher, compare, cherry-pick, stash, amend, undo, stats, history
GitHub Integration — Create Pull Requests and Issues from the terminal
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)

# Download .deb from latest release
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 the binary for your platform 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`

# Example: Linux x64
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

Uninstallation

# Homebrew
brew uninstall geeto && brew untap rust142/geeto

# APT / Debian
sudo dpkg -r geeto

# NPM / Bun
npm uninstall -g geeto   # or: bun remove -g geeto

# Binary (manual)
sudo rm /usr/local/bin/geeto

# From source
curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/uninstall.sh | bash

Quick Start

1. Run

geeto

see demo

On first run, Geeto will automatically guide you through AI provider setup:

Gemini — Enter your API key (get one at Google AI Studio)
OpenRouter — Enter your API key (get one at OpenRouter)
GitHub Copilot — Auto-configured (requires GitHub CLI)

All configurations are saved locally in .geeto/ directory.

2. Follow the Workflow

Geeto guides you through 6 steps:

Stage — Select files to commit
Branch — AI-generated branch name
Commit — AI-generated commit message
Push — Push to remote with progress bar
Merge — Merge to target branch
Cleanup — Delete merged branches

CLI Reference

Workflow

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

Git Tools

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

geeto -pr, --pr    # Create a Pull Request
geeto -i,  --issue # Create an Issue
geeto -t,  --tag   # Release & tag manager with semver

Trello

geeto -tr, --trello          # Open Trello menu
geeto -tl, --trello-list     # List boards and lists
geeto -tg, --trello-generate # Generate tasks from Trello

Settings

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

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
geeto -h, --help

Trello Integration

Generate task instruction files for AI agents:

geeto --trello-generate

Creates .github/instructions/tasks.instructions.md with:

Step-by-step task list from Trello cards
AI agent instructions (execute one task at a time, wait for confirmation)
Backend/Frontend implementation checklists

Development

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

# Build
bun run build

# Development mode (run from source)
bun run dev

# Lint & Type Check
bun run check:fast    # Quick lint
bun run check:full    # Full typecheck + lint

See CONTRIBUTING.md for detailed guidelines.

Contributing

We welcome contributions! Please:

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 you find Geeto helpful, consider supporting the project:

☕ Buy me a coffee on Saweria
⭐ Star this repository
🐛 Report bugs and suggest features
📢 Share with others

License

MIT — see LICENSE for details.