SOMYA NAYAK
HARPER_GRAMMAR_ENGINE.sys ⚡
<- Back to Resources

Harper: The 100% Free Open-Source Grammarly Alternative (Offline & Privacy-First) ⚡

Why spend $144 to $360 every year on Grammarly Premium when Automattic engineered a lightning-fast, code-aware, 100% local Rust grammar engine that never leaves your machine?

⚡ TL;DR

Harper is a high-performance, Apache 2.0 open-source grammar and style checker maintained by Automattic (the company behind WordPress.com, WooCommerce, and Tumblr). Built natively in Rust, Harper runs 100% locally on your machine—meaning zero keystrokes ever touch external cloud servers. It functions completely offline without Wi-Fi, requires zero account registrations or monthly subscriptions, consumes a fraction of the RAM of Electron-based apps, and intelligently ignores code fences and markdown tags. You can run it directly in your browser, Obsidian, VS Code, Cursor, Neovim, or CI/CD terminal pipelines.

SECURITY & PRIVACY

The 4 Fatal Flaws of Grammarly in 2026

For nearly a decade, Grammarly held a near-monopoly over digital proofreading. But as software workflows evolved toward local-first architectures, heavy cloud extensions began showing severe structural weaknesses:

  • 1. The Keystroke Surveillance Problem: To check your prose, Grammarly's browser extension captures your active input field and transmits the raw text over HTTPS to its cloud servers. For corporate executives, medical professionals, legal teams, and developers handling proprietary IP, this represents an unvetted data exfiltration vector.
  • 2. Total Paralysis Without Internet: Traveling on an airplane, working in low-connectivity environments, or experiencing network outages renders cloud proofreading completely non-functional. Harper bundles its entire linguistic engine on-device, meaning you get instantaneous corrections anywhere in the world.
  • 3. The Subscription Paywall Treadmill: Grammarly locks advanced clarity, style tone adjustments, and vocabulary suggestions behind a monthly paywall reaching up to $30/month ($144 to $360 annually). Harper is 100% free under the Apache 2.0 open-source license.
  • 4. Complete Ignorance of Code and Markdown: If you write technical documentation, blog posts in Markdown, or code comments, Grammarly treats variable names like const userAuthToken, shell commands like cargo build --release, and regex patterns as catastrophic spelling errors, cluttering your screen with false positives.
BENCHMARK

Harper vs. Grammarly Premium: Head-to-Head Matrix

Here is how Harper stacks up against Grammarly Premium across operational, performance, and security dimensions:

Feature / Capability Harper (Automattic) Grammarly Premium
Cost & Licensing 100% Free (Apache 2.0 Open Source) $144 – $360 / year per seat
Data Privacy & Telemetry 100% Local (0 bytes sent online) Cloud-dependent (Transmits all text)
Offline Capability Full native offline functionality Completely disabled without Wi-Fi
User Account & Auth Zero sign-in or account required Mandatory login & tracking cookie
Core Engine Language Rust (Native compiled / WebAssembly) Heavy Web/Cloud + Electron backend
Processing Latency < 5 milliseconds (Instant in-memory) 150ms – 600ms (Network roundtrips)
Code & Markdown Awareness AST-aware (Ignores backticks & syntax) Flags code, regex, and variables
Supported Ecosystems Browser, Obsidian, VS Code, Neovim, CLI Browser, MS Word, Desktop app
ENGINEERING

How Harper Works Under the Hood: Rust & AST Parsing

Harper isn't just a simple dictionary lookup; it is a full linguistic engine that evaluates syntactic relationships, common orthographic errors, tautologies, and grammatical dependencies. Automattic designed Harper around three core engineering principles:

1. Zero-Allocation Tokenization

Written in idiomatic Rust, Harper tokenizes sentences with zero unnecessary heap allocations. A 10,000-word document parses in less than 4 milliseconds on a standard laptop.

2. AST-Aware Contextual Masking

Before checking words, Harper builds an Abstract Syntax Tree (AST) of the text. It identifies code fences, HTML tags, inline backticks, and URLs, shielding them from the spellcheck pass.

3. Universal WebAssembly Portability

The core Rust crate compiles seamlessly to WebAssembly (Wasm). This allows web browser extensions to run the exact same native Rust engine inside your browser sandbox with zero network calls.

PLAYBOOK

4 Ways to Set Up & Run Harper Today

Depending on whether you write in browser web forms, markdown note apps, developer IDEs, or automated pipelines, here is how to deploy Harper in minutes:

SETUP 01 Web Browser Extension (Chrome, Firefox, Edge)

If you want a drop-in replacement for the Grammarly browser extension across Gmail, Google Docs, LinkedIn, Reddit, and Twitter:

  1. Navigate to the official site at writewithharper.com or the official Chrome Web Store / Firefox Add-on listing.
  2. Click Install Extension.
  3. Once enabled, Harper immediately begins highlighting typos, grammatical slips, and clarity suggestions inside text fields.
  4. Notice the speed: corrections appear instantly with 0ms network latency because the WebAssembly binary runs 100% on your device.
SETUP 02 Obsidian Community Plugin (Private Second Brain)

Obsidian users maintain local-first vaults for privacy. Using cloud grammar extensions defeats that purpose. Harper integrates natively:

  1. Open Obsidian Settings → Community Plugins.
  2. Turn on Community Plugins, then click Browse.
  3. Search for Harper Grammar Checker and click Install, then Enable.
  4. Harper will highlight grammar and style errors inside your markdown notes in real time without sending your personal journal or work notes to any server.
SETUP 03 VS Code, Cursor & Neovim via Language Server (harper-ls)

Harper ships as an official Language Server Protocol (LSP) server called harper-ls. You can install it globally via Cargo, Homebrew, or your editor's package manager:

# Install via Rust Cargo
cargo install harper-ls

# Or install via Homebrew on macOS/Linux
brew install harper

In VS Code or Cursor, search for the official Harper extension in the Extensions marketplace (Extensions → Harper) and click Install. It activates automatically across Markdown, HTML, Rust, Python, and JavaScript docstrings!

SETUP 04 CLI & CI/CD Linting (harper-cli for Git & Docs)

Automate proofreading across your entire documentation directory before pushing commits to GitHub:

# Install the command line tool
cargo install harper-cli

# Run a grammar check on all documentation files
harper-cli lint ./docs/*.md

# Check your README before publishing a release
harper-cli lint ./README.md

You can integrate this command directly into GitHub Actions or a Husky pre-commit hook to guarantee that zero typos ever slip into public releases.

CONFIGURATION

Configuring Custom Dictionaries, Jargon & Dialects

Every brand, startup, and technical domain has unique jargon—terms like Kubernetes, LLM, ARR, CAC, WebAssembly, Substack, DALL-E, Supabase. Harper lets you define local custom dictionaries so these words are never flagged as spelling mistakes.

In your project directory or home directory, Harper reads configuration settings allowing you to select your preferred English dialect and ignore specific technical rules:

# Harper Configuration File (harper.toml)
[dialect]
language = "American" # Or "British", "Canadian", "Australian"

[user_dictionary]
words = [
  "SaaS", "Supabase", "Postiz", "LangGraph", "GTM", "ROAS", "Automattic"
]

[rules]
avoid_passive_voice = true
repeated_words = true
FAQ

Frequently Asked Questions About Harper

Is Harper really 100% free with no hidden paywalls?

Yes. Harper is released under the Apache 2.0 license by Automattic. There are no premium subscription tiers, no paywalled style rules, no trial periods, and no credit card requirements.

Does Harper need an internet connection to proofread?

No. Harper is completely self-contained. The language rules, dictionaries, and AST parser are compiled into the native binary or local WebAssembly module. You can use it on airplanes, offline cabins, or secure air-gapped corporate servers.

Will my data be used to train AI models?

Never. Because Harper runs 100% locally on your machine, your text never leaves your device and is never uploaded to any cloud server or used for AI training datasets.

Where can I find the official source code and documentation?

You can inspect the entire codebase, contribute, or open issues at the official GitHub repository: github.com/automattic/harper, or explore the documentation at writewithharper.com.

⚡ SCALING AI & GROWTH SYSTEMS?

I help founders, marketing teams, and operators build autonomous GTM operations, local-first developer workflows, and scalable AI infrastructure.

Book a Growth Strategy Consultation ->
Hey, I'm Mini Somya. Click me to chat.