PhilipSchmid/textwarden
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.
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.
AIREADME.md
OriginalTextWarden: Private Grammar Checker for 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.
[!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
- Download the latest TextWarden installer (
.dmg) from GitHub Releases. - Drag TextWarden into the Applications folder and open it.
- Grant Accessibility permission when macOS asks.
- 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:debuggingand selectmanifest.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 |
| 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
- Browser extension preview
- Configuration
- Troubleshooting
- Building from source
- Contributing
- Architecture
- Apple Foundation Models integration
- Application-specific notes
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:
License
TextWarden is available under the Apache License 2.0.