Open Source

The Agent Writes.
You Review.

Install the skill. Your agent handles the rest — npm install, MCP config, launch. Then just ask it to write. You review changes in your browser. Plain .md files on disk.

$ npx openwriter install-skill

One command. The skill teaches your agent how to install, configure, and use OpenWriter.

Accept or Reject. That's It.

When your agent makes changes, they appear as colored decorations. Review with vim-style hotkeys.

Chapter 1 — Origins.md

The morning air was crisp as she stepped onto the platform.

A thin fog clung to the rails, curling around her ankles like something alive.

She checked her watch — the 7:15 was late again, as it had been every day this week.

It was a Tuesday and Tuesdays were always bad.

The station was emptier than usual. That should have been her first warning.

j k navigate a accept r reject A accept all R reject all

How It Works

Install the skill, ask your agent to write, review in your browser.

1

Install the Skill

Run npx openwriter install-skill to install the OpenWriter skill. It teaches your agent how to set everything up — MCP server config, launch, and browser URL. One command, then just ask.

2

Agent Writes

Your agent gets 30 MCP tools to create, edit, and organize documents. It writes directly into your browser — you see changes appear in real time at localhost:5050.

3

You Review

Inserts appear green, rewrites blue, deletions red. Navigate with j/k and accept or reject each change. Your documents save as plain .md files.

Everything You Need to Write with AI

A complete writing environment where agents are first-class collaborators.

30 MCP Tools

Document editing, workspace management, version history, image generation, and import — all via the Model Context Protocol. Works with any MCP agent.

Pending Change Review

Green inserts, blue rewrites, red deletions. Vim-style keyboard navigation. Accept or reject individual changes or all at once.

Multi-Doc Workspaces

Organize documents into workspaces with nested containers, cross-cutting tags, and shared context. Four sidebar views: tree, timeline, board, and shelf.

5 Themes, Light & Dark

Ink, Novel, Mono, Editorial, and Studio — each with light and dark modes. Three typography presets. Customize your writing environment.

Git Sync

Push your documents to GitHub directly from the editor. Three setup methods: GitHub CLI, personal access token, or connect to an existing repo.

Plugin System

Register MCP tools, add HTTP routes, and contribute context menu items. Extend the editor with custom AI actions and integrations.

Works with Any MCP Agent

Add OpenWriter as an MCP server. Your agent gets 30 tools across eight categories — document operations, lifecycle, workspace management, organization, text editing, versioning, image generation, and import.

30 MCP Tools
Real-time WebSocket
Claude Code Skill
Multi-Session Mode
Token-Efficient Wire
Plugin Extensible
Documentation
// Add to your MCP config

  "mcpServers":
    "openwriter":
      "command": "openwriter",
      "args": ["--no-open"]
    
  


// Or with Claude Code:
// claude mcp add -s user openwriter \
// -- openwriter --no-open

Markdown Native

Every document is a .md file on disk. No database, no lock-in. The filesystem is the index.

# Your documents are just files
~/.openwriter/
  Getting Started.md
  Chapter 1 - Origins.md
  Research Notes.md
  _workspaces/
    My Novel.json

Plain Files, Full Power

Move, copy, or grep your files however you want. Open any existing .md from any project. Git Sync built in. YAML frontmatter for metadata. Every LLM reads and writes markdown natively — no conversion layer, no token waste.

No database
Open any .md file
YAML frontmatter
Full markdown fidelity
Version history
Export to HTML/DOCX/PDF

Start Writing with Your Agent

Install in seconds. Connect any MCP agent. Your documents stay as plain markdown files.

Get Started