pairy

pairy is a Neovim plugin that provides GitHub Copilot-style AI assistance (explain, refactor, suggest, test, chat) via Google's Gemini API — free, fully transparent, zero SaaS lock-in. Origin: saw a Copilot invoice, noticed an unused Gemini key, built it in two days.

What It Does

Commands: explain code (floating window), refactor (diff view), suggest completions, generate tests, open chat buffer. Context per request: 50 lines of surrounding code, explicitly bounded.

Architecture

Pure Lua, no SDK dependencies — HTTP calls go directly to the Gemini REST API via libuv async. Config at ~/.config/pairy/config.json (shared with grove). Temperature default: 0.2 for deterministic code generation, tunable.

Design Philosophy

> "Own your tools."

Every line readable. No black box. Acknowledged tradeoffs: no streaming yet, no codebase-wide context (Cursor wins there), async race conditions not bulletproof. Copilot is better for large-repo context; pairy wins on cost (zero) and transparency (complete).

Related Pages

• grove
• Projects
• Software Craftsmanship

Sources

• GitHub Repo: pairy - wiki/sources/github/pairy.md
• Website Source: blog / pairy_blog - wiki/sources/website/blog-pairy-blog.md

Evidence

Linked source: GitHub Repo: pairy

Linked source: Website Source: blog / pairy_blog