docs: rewrite README for a non-technical audience

[FuJacob]

What & why

Feedback we got: the README reads as too technical. The primary audience on this page is the 6000+ people deciding whether to install — not contributors. This pass keeps the layout, badges, and CTAs (download + support stay up top) and rewrites the prose to be user-first.

Changes

• Engines section de-jargoned. Leads with the plain choice — Apple Intelligence vs Open Source — plus a model table with a "Good for" column. GGUF/llama.cpp internals, raw model filenames, quant notes, and bring-your-own are moved into a collapsed <details> for power users. Engine labels still match the in-app Settings wording.
• Keyboard model fixed (correctness). The old copy implied Tab accepts the whole suggestion. It accepts the next word; backtick accepts the whole thing; Esc dismisses. Added a short Using Cotabby section spelling this out.
• New Privacy section — on-device, no telemetry, no disk writes, network only for model downloads + update checks.
• Features de-jargoned — dropped "via llama.cpp", "OCR", "on-screen awareness".
• Permissions — noted Screen Recording is optional (Make Screen Recording permission optional #633) and that secure fields are never read.
• Typography — spaced hyphens / -- → em-dashes.

Open question

• The Ko-fi link here is ko-fi.com/I2F22066MI; the landing site uses ko-fi.com/cotabby. Left as-is to avoid touching a payment link — worth unifying if they're the same account.

🤖 Generated with Claude Code

Greptile Summary

This PR rewrites README.md to prioritize the non-technical installer audience: it de-jargons the Engines section, adds Privacy and Using Cotabby sections, collapses GGUF/llama.cpp internals behind a <details> block, and corrects the keyboard model (Tab → next word, backtick → whole suggestion).

• The keyboard shortcut correction (Tab accepts a word, not the whole suggestion) is a genuine accuracy fix that matches the acceptCurrentSuggestion() implementation.
• Two Settings navigation paths in the new prose point to panel names that don't match the app's sidebar: Settings → Engine (actual label: Engine & Model) and Settings → Acceptance Mode (a picker inside Shortcuts, not its own pane).

Confidence Score: 3/5

The README rewrite is largely accurate and well-structured, but two navigation instructions direct users to Settings panel names that don't match the app UI.

The prose and keyboard model corrections are solid. However, two user-facing navigation paths ("Settings → Engine" and "Settings → Acceptance Mode") reference labels that don't exist in the Settings sidebar — the actual panels are "Engine & Model" and "Shortcuts" respectively. Users who follow these instructions verbatim will be confused when they don't find the named panel.

README.md — specifically the "Engines" and "Using Cotabby" sections where Settings navigation paths are specified.

Important Files Changed

Filename	Overview
README.md	Non-technical rewrite of the README: de-jargoned engines section with a collapsed advanced details block, new Privacy and Using Cotabby sections, corrected Tab/backtick keyboard model. Two Settings navigation paths reference incorrect panel names ("Engine" vs "Engine & Model"; "Acceptance Mode" instead of "Shortcuts").

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User opens Settings] --> B{Engine choice}
    B -->|macOS 26+ / Apple Silicon| C[Apple Intelligence]
    B -->|macOS 14+, any Mac| D[Open Source Engine]
    D --> E{Pick a model}
    E --> F[tabby-2-nano ~0.8 GB]
    E --> G[tabby-2-mini ~1.4 GB]
    E --> H[tabby-2-base ~4.5 GB]
    E --> I[tabby-2-pro ~5.0 GB]
    E --> J[Bring Your Own GGUF]

    subgraph Suggestion Flow
        K[User types] --> L{Suggestion appears?}
        L -->|Yes| M[Tab: accept next word]
        L -->|Yes| N[Backtick: accept whole suggestion]
        L -->|Yes| O[Esc / keep typing: dismiss]
        L -->|No| K
    end

Loading

_{Reviews (1): Last reviewed commit: "docs: rewrite README for a non-technical..." | Re-trigger Greptile}

Greptile also left 2 inline comments on this PR.

[greptile-apps]

The Settings sidebar label for the engine pane is "Engine & Model" (see SettingsCategory.engineAndModel → "Engine & Model" in SettingsCategory.swift), not just "Engine". A user following this navigation path will scan the sidebar for a pane called "Engine" and may not find it immediately.

Suggested change

	Cotabby generates suggestions one of two ways. You choose which in Settings → Engine:
	Cotabby generates suggestions one of two ways. You choose which in Settings → Engine & Model:

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

[greptile-apps]

"Acceptance Mode" is not a top-level Settings pane — it's a picker control inside the "Shortcuts" pane (AcceptanceModePickerView is rendered by ShortcutsPaneView). Users following "Settings → Acceptance Mode" will look for a sidebar entry that doesn't exist. The correct navigation is "Settings → Shortcuts".

Suggested change

	- **`Tab`** — accept the next word. (Prefer whole phrases? Switch this in Settings → Acceptance Mode.)
	- **`Tab`** — accept the next word. (Prefer whole phrases? Switch this in Settings → Shortcuts.)

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!