Skip to content
Projects

PhilipSchmid/textwarden has 45 GitHub stars and 2 forks. GitHot measured -1 stars in 24 hours. Last checked 2026-11-15 20:35 UTC. Last push 2026-11-09.

How these counts are measured

What you can do

  • Real-time English grammar, spelling, punctuation, capitalization, and word-choice suggestions
  • One-click corrections and a Fix All command for clear-cut errors
  • American, British, Canadian, Australian, and Indian English dialects
  • Custom vocabulary, the macOS learned-word dictionary, and optional word lists for technical terms, names, brands, abbreviations, and slang

Measured star growth

in 24h
-1
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Grammar checking that respects your privacy. Real-time spelling and style suggestions across all macOS apps, running entirely on-device.

AI

README.md

Original

TextWarden: Private Grammar Checker for macOS

CI Latest release License macOS

TextWarden is a free, open-source grammar checker and writing assistant for macOS. It checks English spelling, grammar, punctuation, and style while you type.

Nothing you type is sent anywhere. Your writing never leaves your Mac: not for grammar checking, not for AI features, and not for analytics. There is no account to create and no subscription.

TextWarden macOS grammar checker logo

Download TextWarden for macOS

[!NOTE] TextWarden is under active development. Apps do not all share text with macOS in the same way, so underlines and corrections may work differently from one app to another. If something breaks, please open a bug report.

Why TextWarden?

  • Your writing stays on your Mac: Grammar checks run locally with Harper, and optional AI features use Apple Intelligence on your Mac. TextWarden never uploads your text or prompts.
  • Works in many Mac apps: Check writing in Apple apps, browsers, chat apps, web-based editors, and Microsoft Office.
  • Fast feedback: TextWarden underlines errors when an app provides the location of each word. Otherwise, a small floating indicator shows the suggestions.
  • A rewrite without leaving your app: Improve selected text using your preferred writing style, then review the changes before applying them.
  • No account or subscription: Download the app and grant Accessibility permission. Your usage statistics and custom dictionary stay on your Mac.

Features

  • Real-time English grammar, spelling, punctuation, capitalization, and word-choice suggestions
  • One-click corrections and a Fix All command for clear-cut errors
  • American, British, Canadian, Australian, and Indian English dialects
  • Custom vocabulary, the macOS learned-word dictionary, and optional word lists for technical terms, names, brands, abbreviations, and slang
  • Optional detection of 69 selectable non-English languages to avoid false positives in multilingual documents
  • Readability scores and sentence-complexity underlines for text with at least 30 words
  • Browser extension preview with precise underlines and native writing tools
  • Per-app pause controls, per-app underline controls, and website exclusions
  • A built-in Sketch Pad for focused drafting and revision
  • Optional automatic updates, with a separate channel for experimental releases

Apple Intelligence writing tools

On macOS 26 or later, a compatible Mac with an Apple M-series chip can use Apple's built-in, on-device AI for:

  • Style suggestions for clear, concise, formal, casual, or business writing
  • Quick Rewrite, which proposes improvements to selected text using your configured writing style
  • AI Compose, which drafts from your instructions or rewrites selected text with a specific instruction
  • Sentence simplification and readability tips
  • Quick actions in Sketch Pad for professional, friendly, concise, or refined rewrites

These features are off by default. Grammar checking, spell checking, custom dictionaries, language detection, and readability scoring do not require Apple Intelligence.

Quick Rewrite

Quick Rewrite uses Apple Intelligence to suggest changes to selected text in supported apps, following your writing style from Preferences → Style. Compare the original and rewritten text before applying; nothing changes without your approval. AI can change meaning, so review the result carefully.

See Quick Rewrite configuration for setup, shortcuts, and limits.

Requirements

  • macOS 14 Sonoma or later
  • An Intel or Apple Silicon Mac
  • Accessibility permission, so TextWarden can read and update text in other apps

Apple Intelligence features additionally require macOS 26, a supported Mac with an Apple M-series chip, and Apple Intelligence enabled in System Settings.

Install TextWarden

  1. Download the latest TextWarden installer (.dmg) from GitHub Releases.
  2. Drag TextWarden into the Applications folder and open it.
  3. Grant Accessibility permission when macOS asks.
  4. Start typing in a supported app.

The download works on both Intel and Apple Silicon Macs. To avoid overlapping suggestions, turn off the other app's built-in spelling and grammar checker when you use TextWarden there.

See the Configuration Guide for every setting and the Troubleshooting Guide if the app, indicator, or underlines do not behave as expected.

Browser Extension (Preview)

The extension adds precise underlines and TextWarden’s writing tools to Chrome, Brave, Firefox, Zen, and Safari. Your writing stays on your Mac. Google Docs and complex web editors are not supported yet.

Use a preview-enabled TextWarden build and open Preferences → Browser → Install Extension:

  • Chrome / Brave: Enable Developer mode and Load unpacked from the revealed folder.
  • Firefox / Zen: Load Temporary Add-on in about:debugging and select manifest.json. Repeat after each browser restart.
  • Safari: Enable the bundled extension in Safari → Settings → Extensions. Signed, notarized builds need no Developer mode.

Click the toolbar feather on a page to start checking. Installation is manual during the preview; it is not listed in extension stores. See the extension guide for setup and privacy details.

How It Works

After you grant permission, TextWarden reads the text field you are typing in and checks it locally with the bundled Harper grammar checker. Suggestions appear as underlines or in a small floating indicator beside the app. If you enable Ignore selected languages, TextWarden uses local language detection to skip English grammar checks only in passages it identifies confidently as one of your selected languages.

When Apple Intelligence features are enabled, TextWarden gives the current text or selection to Apple's on-device AI. TextWarden does not operate a grammar or AI server.

Supported Apps

TextWarden is tuned for the apps below. Some apps give macOS less information about their text fields than others, so the exact experience varies.

Application Grammar checking Visual underlines
Slack Full Full
Claude Full Full
ChatGPT Full Full
Perplexity Full Full
Safari, Chrome, and Brave Full[^extension] Extension preview[^extension]
Firefox and Zen Full[^extension][^gecko] Extension preview[^extension]
Comet Full Indicator only[^browsers]
Apple Mail Full Full
Apple Notes Full Full
Apple Messages Full Full
Apple Calendar Full Full
Apple Pages Full Full
Apple Reminders Full Full
TextEdit Full Full
Notion Full Partial[^notion]
Telegram Full Full
WhatsApp Full Full
Webex Full Full
Microsoft Word Full Full
Microsoft PowerPoint Notes only[^powerpoint] Notes only[^powerpoint]
Microsoft Outlook Full Full
Microsoft Teams Full Full
Proton Mail Full Full
Microsoft Excel Not supported Not available

[^notion]: Notion does not make every text block available to macOS at once, so some errors appear in the indicator without an underline. See Notion support notes. [^powerpoint]: PowerPoint lets TextWarden read speaker notes, but not text boxes on slides. See PowerPoint support notes. [^browsers]: Without an extension, browser checking uses macOS Accessibility and shows the floating indicator instead of precise underlines. Comet has no extension preview. [^extension]: Browser support covers text fields and simple rich-text editors; Google Docs and complex web editors are not supported yet. Precise underlines require the extension preview, activated on the page through its toolbar. [^gecko]: Without the extension, Firefox and Zen can also show suggestions in read-only fields because of a browser accessibility bug.

Website editors vary, especially editors with formatting controls. Before TextWarden reads text in an unrecognized app, it asks whether you want to try it safely or keep it paused. A safe trial uses the floating indicator and copy-only fixes; underlines and direct edits stay off. You can change this choice later in Preferences → Applications.

Terminal apps are paused by default because command output and source code produce poor grammar-checking results.

Privacy: Nothing You Write Leaves Your Mac

TextWarden does not send your writing anywhere. It has no cloud grammar service, remote AI model, analytics, telemetry, advertising, or automatic crash reporting. Your text, AI prompts, corrections, custom vocabulary, settings, usage statistics, logs, and diagnostic reports stay on your Mac.

Grammar checks, language detection, and readability scores run inside TextWarden. Optional AI features run on your Mac through Apple Intelligence. Nothing is uploaded for processing.

If you enable update checks, TextWarden downloads release information from GitHub. The update check does not upload your writing, prompts, usage data, logs, or diagnostics.

Logs can contain parts of your writing, especially with Debug or Trace logging enabled, but they remain on your Mac. TextWarden only creates a diagnostic ZIP when you ask it to, and it never uploads that file for you. Review the file yourself before choosing to share it.

Known Limitations

  • Grammar checking is English-only. Language detection can suppress checks for 69 selected non-English languages, but it does not proofread or translate them. Very short or ambiguous passages remain checked when detection is uncertain.
  • Some custom text editors do not give macOS enough information for accurate underlines or safe corrections.
  • A correction can remove formatting in apps that only let TextWarden replace the entire text field.
  • Apple Intelligence style and composition features are unavailable on Intel Macs and on macOS releases before 26.
  • TextWarden is a macOS app. There are no Windows, Linux, iOS, or Android versions.

Project Documentation

Credits

TextWarden uses Harper, an open-source English grammar checker written in Rust. It also depends on swift-bridge, Whatlang, KeyboardShortcuts, LaunchAtLogin-Modern, Sparkle, swift-markdown, STTextView, and ConfettiSwiftUI.

The codebase was developed with substantial AI assistance and human review. The TextWarden logo was created with Recraft.

Support the Project

TextWarden is maintained as a side project. If it helps your writing, you can support its development:

Support TextWarden on Buy Me a Coffee

License

TextWarden is available under the Apache License 2.0.