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
Trello Integration - Link branches to Trello cards, generate task lists for AI agents
Checkpoint Recovery - Resume interrupted workflows from any step
Cross-Platform - macOS, Linux, Windows

Installation

NPM/Bun

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

From Source

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

Requirements: Node.js ≥ 18, Bun ≥ 1.0, Git ≥ 2.0

Uninstallation

NPM/Bun

npm uninstall -g geeto
# or
bun remove -g 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
Merge - Merge to target branch
Cleanup - Delete merged branches

CLI Flags

geeto --stage          # Start from stage step
geeto --branch         # Start from branch creation
geeto --commit         # Start from commit step
geeto --push           # Start from push step
geeto --merge          # Start from merge step
geeto --cleanup        # Branch cleanup workflow
geeto --trello         # Trello integration menu
geeto --settings       # Configure AI providers

Trello Integration

Generate task instruction files for AI agents:

geeto --trello-generate

Creates .github/instructions/tasks.instructions.md (VSCode) or editor-specific paths with:

Step-by-step task list from Trello
AI agent instructions (execute one task at a time)
Backend/Frontend best practices

Development

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

# Build
bun run build

# Development mode
bun run dev

# Lint & Type Check
bun run check:fast
bun run check:full

See CONTRIBUTING.md for detailed guidelines.

Contributing

We welcome contributions! Please:

Fork the repository
Create a branch: dev#your-feature
Make your changes
Run tests: 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

This project is licensed under the MIT License.