Home

Tabby is a macOS menu bar app that provides on-device inline autocomplete in any text field. It watches Accessibility focus, generates a continuation through Apple Intelligence or a local llama.cpp model, renders ghost text near the caret, and inserts accepted text when you press Tab.

First Time Contributing?

1. Get building - follow CONTRIBUTING.md (prerequisites, clone, build, test, lint)
2. Understand the loop - read How Tabby Works to see how a keystroke becomes a suggestion
3. Pick an issue - browse issues labeled good first issue
4. Read the right guide - use the table below to find the page that matches your task

What Do You Want To Do?

Task	Start here
Fix a suggestion bug	How Tabby Works then Debugging Guide
Add a new setting or UI control	How To Add a Feature
Fix overlay positioning	How Tabby Works (Focus Tracking) then Debugging Guide
Improve support for a specific app	App Compatibility Notes
Understand the privacy model	Privacy and Safety Model
Ship a release	RELEASING.md

Repo Documentation

Document	What it covers
README	Product overview, installation, features, model table
ARCHITECTURE	System design, layer boundaries, file reading order
CONTRIBUTING	Setup, build, test, lint, PR guidelines
RELEASING	Sparkle keys, release flow, rollback