Getting Started

OpenWriter is a markdown-native rich text editor with AI agent collaboration. Install it globally and start writing.

One command installs OpenWriter globally, configures the MCP server, and teaches your agent how to use it:

npx openwriter install-skill

Restart Claude Code, then type /openwriter to start writing.

Any MCP Agent

Install globally and add OpenWriter as an MCP server in your agent’s config:

npm install -g openwriter
{
  "mcpServers": {
    "openwriter": {
      "command": "openwriter",
      "args": ["--no-open"]
    }
  }
}

Launch the Editor

openwriter

Your browser opens to localhost:5050. That’s your editor. (Claude Code launches it automatically via MCP — you only need this for standalone use.)

Your First Document

  1. Open localhost:5050 in your browser
  2. Click New Document in the sidebar
  3. Start writing — or ask your agent to write for you
  4. Agent changes appear as colored decorations:
    • Green — inserts
    • Blue — rewrites
    • Red — deletions
  5. Navigate with j/k, accept with a, reject with r

File Storage

Your documents live at ~/.openwriter/ as plain .md files. No database, no lock-in. Open them in any editor, grep them, version them with git.

Next Steps