whatisgithub

What is better-write?

sushantjarial/better-write — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · writerComplexity · 2/5LicenseSetup · moderate

In one sentence

A Raycast extension that rewrites selected text using any OpenAI compatible language model and your own API key.

Mindmap

mindmap
  root((Better Write))
    What it does
      Rewrites selected text
      Five rewrite modes
      Replaces in place
    Tech stack
      TypeScript
      Raycast
      OpenAI API
    Use cases
      Grammar fixing
      Tone rewriting
      Private local rewriting
    Audience
      Writers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Fix grammar and spelling in any app without leaving your keyboard.

USE CASE 2

Rewrite an email or message to sound more professional before sending.

USE CASE 3

Rephrase a paragraph for clarity using your own AI provider.

USE CASE 4

Run a fully local, private text rewriting workflow with Ollama or LM Studio.

What is it built with?

TypeScriptRaycastOpenAI API

How does it compare?

sushantjarial/better-write0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires your own API key from an OpenAI compatible provider, or a locally running model.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Better Write is an extension for Raycast, a keyboard driven launcher that lets you trigger commands from anywhere on your computer, that rewrites whatever text you have selected using an AI language model. Instead of copying text into a separate chat window, you highlight it in any app, run one of the extension's commands, and the rewritten version replaces your selection in place with no extra confirmation step. The extension offers five commands, each of which can get its own keyboard shortcut in Raycast: Fix Grammar corrects grammar, spelling, and punctuation while keeping your voice, Rephrase rewrites for clarity at roughly the same length, Make Friendly gives text a warmer, more conversational tone, Make Professional makes it sound clean and business appropriate, and Expand adds more detail and improves clarity. All five are thin wrappers around one shared workflow that grabs the current selection, sends it to the configured model, and pastes the result back. Under the hood, the extension talks to any model provider that supports the OpenAI style chat completions API, and you bring your own API key. The README lists OpenAI, OpenRouter, Groq, DeepSeek, and an OpenAI compatible Anthropic endpoint as supported cloud providers, plus local options like Ollama and LM Studio for anyone who wants to run a model entirely on their own machine with nothing sent anywhere else. Setup means installing the extension, opening its preferences in Raycast, and filling in the API key, base URL, and model name for your chosen provider, with the option to customize the system prompt behind each command. The code is written in TypeScript. According to the README, your selected text is sent only to whichever provider you configure and nothing is logged elsewhere. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me add a new custom rewriting command to this Raycast extension.
Prompt 2
Show me how to point this extension at a local Ollama model for private rewriting.
Prompt 3
Explain how the shared workflow ties the five commands together.
Prompt 4
Write a system prompt for a new Make Concise command for this extension.

Frequently asked questions

What is better-write?

A Raycast extension that rewrites selected text using any OpenAI compatible language model and your own API key.

What language is better-write written in?

Mainly TypeScript. The stack also includes TypeScript, Raycast, OpenAI API.

What license does better-write use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is better-write to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is better-write for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.