Writing Tools

🍎 Using a Mac? Jump to the macOS (Native Swift Port) section → macOS

Instantly proofread and optimize your writing system-wide with AI:

https://github.com/user-attachments/assets/d3ce4694-b593-45ff-ae9a-892ce94b1dc8

Summarize content (webpages, YouTube videos, documents...) in a click:

https://github.com/user-attachments/assets/76d13eb9-168e-4459-ada4-62e0586ae58c

Add your own buttons for unlimited potential!

✨ What is Writing Tools?

Writing Tools is an Apple Intelligence-inspired application for Windows, Linux, and macOS that supercharges your writing with an AI LLM (cloud-based or local).

With one hotkey press system-wide, it lets you fix grammar, optimize text according to your instructions, summarize content (webpages, YouTube videos, etc.), and more.

It's currently the world's most intelligent system-wide grammar assistant, works in ~any language, and has been featured in 🔥 28+ global publications (Beebom, XDA, How-To Geek, Neowin, Windows Central...).

Writing Tools was also among the 🔥 top 10 most trending AI programs in the world on GitHub in October 2024.

---

Hi! I'm Jesai, a high school student from Bangalore, and I created and maintain Writing Tools with help from our amazing contributors. I want to especially shout out momokrono, who's contributed extensively, and Arya Mirsepasi, who built the entire macOS port!

Writing Tools will always remain completely free and open-source.

If you find value in it, it would mean the world to me if you could support us as we continue to improve it. ❤️

<table> <tr> <td><b>Support Jesai</b> (Windows/Linux):</td> <td><b>Support Arya</b> (macOS):</td> </tr> <tr> <td><a href="https://www.buymeacoffee.com/jesaitarun" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;"></a></td> <td><a href="http://buymeacoffee.com/aryamirsepasi" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;"></a></td> </tr> </table>

---

⚡ What can I do with Writing Tools, exactly?

1️⃣ Hyper-intelligent Writing Tools:

• Select any text on your PC and invoke Writing Tools with ctrl+space.
• Choose Proofread, Rewrite, Friendly, Professional, Concise, or even enter custom instructions (e.g., "add comments to this code", "make it title case", "translate to French").
• Your text will instantly be replaced with the AI-optimized version. Use ctrl+z to revert.

2️⃣ Powerful content summarization that you can chat with:

• Select all text in any webpage, document, email, etc., with ctrl+a, or select the transcript of a YouTube video (from its description).
• Choose Summary, Key Points, or Table after invoking Writing Tools.
• Get a pop-up summary with clear and beautiful formatting (with Markdown rendering), saving you hours.
• Chat with the summary if you'd like to learn more or have questions.

3️⃣ Go wild with your own buttons!

• They're your own magic buttons. Dream, and it'll magically be done with AI.

3️⃣ Chat with an LLM anytime in a click:

• Press ctrl+space without selecting text to start a conversation with your LLM (for privacy, chat history is deleted when you close the window).

🌟 Why Choose Writing Tools?

Aside from being the only Windows/Linux program like Apple's Writing Tools, and the only way to use them on an Intel Mac or in the EU:

• More intelligent than Apple's Writing Tools and Grammarly Premium: Apple uses a tiny 3B parameter model, while Writing Tools lets you use much more advanced models for free (e.g., Gemini 2.0 Flash [~30B]). Grammarly's rule-based NLP can't compete with LLMs.
• Completely free and open-source: No subscriptions or hidden costs. Bloat-free and uses ~0% of your CPU even when actively using it.
• Versatile AI LLM support: Jump in quickly with the free Gemini API & Gemini 2.0, or an extensive range of local LLMs (via Ollama [instructions], llama.cpp, KoboldCPP, TabbyAPI, vLLM, etc.) or cloud-based LLMs (ChatGPT, Mistral AI, etc.) through Writing Tools' OpenAI-API-compatibility.
• Does not mess with your clipboard, and works system-wide.
• Privacy-focused: Your API key and config files stay on your device. NO logging, diagnostic collection, tracking, or ads. Invoked only on your command. Local LLMs keep your data on your device & work without the internet.
• Supports multiple languages: Works with any language and translates text better than Google Translate (type "translate to [language]" in Describe your change...).
• Code support: Fix, improve, translate, or add comments to code with Describe your change...."
• Themes, Dark Mode, & Customization: Choose between 2 themes: a blurry gradient theme and a plain theme that resembles the Windows + V pop-up! Also has full dark mode support. Set your own hotkey for quick access.

✅ 1 Minute Installation

🪟 Windows:

1. Go to the Releases page and download the latest Writing.Tools.zip file.
2. Extract it to your desired location (recommended: Documents or App Data/Local), run Writing Tools.exe, and enjoy! :D

Note: Writing Tools is a portable app. If you extract it into a protected folder (e.g., Program Files), you must run it as administrator at least on first launch so it can create/edit its config files (in the same folder as its exe).

PS: Go to Writing Tools' Settings (from its tray icon at the bottom right of the taskbar) to enable starting Writing Tools on boot.

🐧 Linux (work-in-progress):

Run it from the source code

Writing Tools works well on x11. On Wayland, there are a few caveats:

• it works on XWayland apps
• and it works if you disable Wayland for individual Flatpaks with Flatseal.

<a id="macos"></a>

🍎 macOS

The macOS version is a native Swift port, developed by Arya Mirsepasi. View the README inside the macOS folder to learn more.

To install it:

1. Go to the Releases page and download the latest macOS .dmg file.
2. Open the .dmg file, also open a Finder Window, and drag the writing-tools.app into the Applications folder. That's it!

Note: macOS 14 or later is required due to accessibility API requirements.

---

💎 Why the macOS port is special

• Truly native: Built in Swift (SwiftUI + AppKit where needed) for a fast, polished Mac experience.
• Private & on-device: Run local LLMs with MLX on Apple Silicon — no internet required for on-device models.
• Rich-text aware: Proofread preserves RTF formatting (bold, italics, lists, links) so your documents keep their look while errors disappear.
• Your workflows, your way: Edit and add your own commands and assign custom shortcuts.
• Multilingual by design: App UI supports English, German, French, and Spanish, and commands work in many more languages.
• Choice of intelligence: Connect to top providers or go fully local — switch any time.
• Themes: Multiple themes (including dark mode) to match your desktop vibe.

🧠 Providers & Models on macOS

• Cloud: OpenAI, Google (Gemini), Anthropic, Mistral, OpenRouter
• Local: Ollama (via OpenAI-compatible endpoint) and MLX on Apple Silicon for first-class, low-latency on-device inference
• You can mix & match: keep sensitive work on-device with MLX, use cloud models when you need the biggest brains.

🖱️ System-wide magic on macOS

• Works across most Mac apps — select text, invoke Writing Tools, and instantly Proofread, Rewrite, Change tone, or Summarize.
• Start a quick chat with your chosen model without selecting text.

Tip: If your shortcut clashes with Spotlight or Input Source switching, set a custom hotkey in Writing Tools and/or adjust macOS settings under
System Settings → Keyboard → Keyboard Shortcuts (Spotlight / Input Sources).

🔐 First-launch permissions (macOS)

For full functionality, macOS will prompt you to grant:

• Accessibility (to read/replace selected text)
• Screen Recording (for certain apps that restrict text access)

You