genie

🧞 Genie - Powerful AI for Your Command Line

Transform your terminal into an AI-powered workspace. Born from a developer's need for control and transparency in AI assistance.

🚀 Quick Start

Installation

macOS (Homebrew)

brew tap kcaldas/genie
brew install genie

Direct Download

# Download latest release
curl -L https://github.com/kcaldas/genie/releases/latest/download/genie_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv genie /usr/local/bin/

Docker

docker run --rm -it ghcr.io/kcaldas/genie:latest

Build from Source

go install github.com/kcaldas/genie/cmd/genie@latest

Configuration

Get a free Gemini API key:

1. Generate a key from Google AI Studio
2. Set it as an environment variable:

export GEMINI_API_KEY="YOUR_API_KEY"
genie ask "hello world"              # CLI mode
git diff | genie ask "commit msg?"   # Unix pipes
genie                                # Interactive TUI mode

💡 Tip: The Gemini API provides 100 free requests per day with Gemini 2.5 Pro. Upgrade to a paid plan for higher rate limits.

📖 Full setup guide: docs/INSTALLATION.md

🎭 Personas

Genie supports different personas for specialized tasks:

# Use specific personas
genie --persona engineer ask "review this code"
genie --persona product-owner ask "plan this feature"

📖 Learn more: docs/PERSONAS.md

💡 Philosophy

Inspired by Lazygit, Claude Code, and Aider, and built for the Unix philosophy: composable, transparent, and adaptable.

Core beliefs:

• Give you control - Understand what's happening, not just trust a black box, and is infinitely hackable
• Integrate naturally - Work with your existing tools, don't replace them
• Respect the terminal - Embrace the power and flexibility of the command line
• Stay composable - Pipe, redirect, script, and automate freely

Whether you're coding, managing projects, taking notes, or automating workflows, Genie adapts to your needs.

📚 Documentation

• Installation & Setup - Complete installation guide
• TUI Guide - Interactive interface features
• CLI Usage - Command line examples
• Configuration - Customization options
• Personas - AI personality system
• Docker Usage - Container setup
• Architecture - How Genie works
• Contributing - Join the project

🔗 Ecosystem

• kcaldas/genie.nvim - Neovim companion plugin

🙏 Acknowledgments

Built with Google Gemini AI • gocui • GoReleaser

Made with ❤️ for developers who love the command line