Local by default

How Refine works on your Mac

By default, Refine checks your writing with a model running on your Mac. If you connect an AI provider, assigned requests go straight there—not through Refine servers. Setup and licensing can still need internet.

Where checks run
On your Mac, unless you choose a provider
What Refine reads
Text the active app exposes through macOS Accessibility
Who changes the text
You do, after reviewing the suggestion

One writing check

From the active app to a suggested edit

  1. 01

    Refine reads the active text field

    With Accessibility permission, Refine uses the text and on-screen position an app exposes to macOS. What's available depends on the app.

  2. 02

    The selected model checks it

    A downloaded model runs on your Mac. Tasks assigned to an optional provider go there instead.

  3. 03

    Refine shows the proposed edit

    Grammar and fluency changes appear as highlights and suggestion cards. Open one when you want to request or view an explanation.

  4. 04

    You accept or skip it

    Apply or dismiss the suggestion, or exclude a change and keep the rest.

For each writing task

Choose where each request runs

Choose a provider separately for grammar, fluency, explanations, translation, and rewriting. Tasks set to Local Model all use the local model currently selected in Refine.

Default

Local model

Text in appRefine on MacLocal model
  • Your Mac runs the downloaded model.
  • When a task uses the local model, the text sent for that check and the response stay on your Mac.
  • Once downloaded, the local model can run without internet.
  • All tasks set to Local Model share the currently selected local model.

Optional

Bring Your Own Key (BYOK)

Text in appRefine on MacYour provider
  • Connect a provider only if you want to use one.
  • Refine stores your API key in the macOS system keychain.
  • Your Mac sends requests straight to the provider; Refine doesn't proxy them.
  • The provider's own terms, retention, and privacy practices apply.

What still needs internet

A downloaded local model can run checks without internet. Downloads, license services, and hosted-provider requests still need a connection.

For setup steps and licensing details, read the offline grammar checker guide.

Where your data goes

Local checks and Keychain storage stay on your Mac. The table summarizes when other data can leave, where it goes, and what is sent; see the Privacy Policy for details.

Local-model checks

Leaves your Mac?
No
Destination
Your Mac
What happens
The text sent to the local model and its response stay on your Mac.

Stored API keys and license data

Leaves your Mac?
No
Destination
Your Mac
What happens
Refine stores them in non-syncing system Keychain items.

Synced preferences and data

Leaves your Mac?
Yes—when iCloud is available
Destination
iCloud
What happens
Supported preferences and data use iCloud-backed storage, with a local fallback when it is unavailable.

Hosted-provider requests

Leaves your Mac?
Yes—for tasks assigned to a hosted provider
Destination
That provider
What happens
Prompts and context go straight to that provider, and responses return directly to your Mac. None of it passes through Refine servers.

Local server requests

Leaves your Mac?
Depends on where the server runs
Destination
Your configured endpoint
What happens
Ollama, LM Studio, and custom compatible endpoints receive requests at the address you configure. If the server runs on this Mac, the request stays on this Mac.

Suggestion reports

Leaves your Mac?
Yes—only when you choose Report
Destination
Refine
What happens
The relevant excerpt before and after the suggested edit, the suggestion type, language, provider and model names, any custom instructions, and your Refine and macOS versions.

Crash reporting

Leaves your Mac?
Yes—when crash reporting is on
Destination
Sentry
What happens
Crash reporting starts enabled and can be turned off. It is used to diagnose technical problems with Refine, not to analyze your writing.

Launch ping

Leaves your Mac?
Yes—at launch
Destination
Refine
What happens
A random anonymous ID, app version, platform, OS version, and timestamp.

Setup survey

Leaves your Mac?
Yes—only if you submit it
Destination
Refine
What happens
Your selected answers, any free text, anonymous ID, Refine and macOS versions, and survey configuration version.

License validation and activation

Leaves your Mac?
Yes—during validation or activation
Destination
Refine
What happens
Validation sends your license key, email, and a device ID. Activation also sends the OS version and hardware information. The device ID is separate from the anonymous launch ID.

Inline checking depends on the app

Inline checking depends on the text and position each app exposes through macOS Accessibility. When an app exposes too little, use the Floating Editor instead.

See tested workflows, limitations, and fallbacks in the Mac app compatibility guide.

See how it handles your writing

The seven-day trial doesn't require a credit card. Try Refine in the apps you use, with your languages and preferred model.

By using Refine, you agree to the Terms & Conditions.