Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Openwriter

FreeNot checked

The open-source writing surface for AI agents. Markdown-native editor with pending change review — your agent writes, you accept or reject.

GitHubEmbed

About

The open-source writing surface for AI agents. Markdown-native editor with pending change review — your agent writes, you accept or reject.

README

Your agent writes. You decide.

The open-source writing surface for the agentic era.

OpenWriter is a markdown-native rich text editor built for humans and agents working side by side. Your agent writes, and you review and approve every change before it lands. Documents are plain .md files on disk, so there's no database and no lock-in, and it works with any MCP-compatible agent.

OpenWriter: your agent writes, you review


Why OpenWriter?

Coding agents like Claude Code, Codex, and OpenCode changed how people build software. That power never reached writing. Ask an agent to edit your essay and you're stuck reading raw markdown in a terminal, with no surface to review changes and no real workflow.

Every writing tool is racing to bolt on its own weak agent. They have it backwards. The strongest agents already exist, and they're built to drive tools rather than sit trapped inside one. OpenWriter ships no agent of its own. It's the writing surface built for the agent you already run, with a review system that keeps you the author of every word.

Markdown is the native language of AI. Every model reads it, writes it, works in it. OpenWriter treats .md as a first-class citizen. Your documents are plain markdown on disk, and the editor adds rich formatting, workspaces, version history, and agent review on top. No proprietary format. No database. Just files.

The agent writes. You accept or reject. That's it.


Quick Start

One command installs the skill, wires up the MCP server, and gets your agent (Claude Code, Cursor, Codex, and 20+ others) ready to write:

npx openwriter setup

That's everything. Restart your agent and start writing — your agent drives the editor, opens documents, and proposes changes you accept or reject.

Just want to see the editor first? npm install -g openwriter && openwriter opens it at localhost:5050 — no agent needed. Documents save as markdown files in ~/.openwriter/; open any .md from disk or drag files into the sidebar.

Prefer to wire your agent up by hand?

Install the skill:

npx skills add https://github.com/travsteward/openwriter --skill openwriter

Then add the MCP server for the editing tools:

claude mcp add -s user openwriter -- openwriter --no-open

The skill teaches your agent how to use OpenWriter well. The MCP server gives it the document-editing tools. For other MCP agents and the full setup, see the reference.


Features

Markdown native, agent first, no lock-in.

  • Agent collaboration over MCP: 24 tools to read, write, and organize documents, working with any MCP-compatible agent like Claude Code, Cursor, or Codex.
  • Pending-change review: Agent edits arrive as colored decorations, green inserts, blue rewrites, red deletes, accepted or rejected one keystroke at a time.
  • Multi-document workspaces: Group docs into projects with nested containers, tags, and shared context the agent reads to stay consistent.
  • Markdown on disk: Every document is a plain .md file with no database and no proprietary format, so you grep and move them freely.
  • Git sync: Push documents to GitHub straight from the editor.
  • Export: Markdown, HTML, Word, plain text, and PDF.
  • Version history: Automatic snapshots with full rollback.
  • Plugin system: Extend the agent with custom MCP tools, HTTP routes, and right-click actions, and the built-in Author's Voice plugin writes in your own voice.

See the reference for the full MCP tool list, the review hotkeys, the token-efficient wire format, the plugin API, and architecture.


Contributing

Contributions welcome. Please open an issue first to discuss what you'd like to change. Local development setup is in the reference.

License

MIT, by Travis Steward

from github.com/travsteward/openwriter

Install Openwriter in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install openwriter

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add openwriter -- npx -y openwriter

FAQ

Is Openwriter MCP free?

Yes, Openwriter MCP is free — one-click install via Unyly at no cost.

Does Openwriter need an API key?

No, Openwriter runs without API keys or environment variables.

Is Openwriter hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Openwriter in Claude Desktop, Claude Code or Cursor?

Open Openwriter on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Openwriter with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs