explaingit

spacezephyr/cowrite

Analysis updated 2026-05-18

33TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

TLDR

A local writing canvas where you edit articles in the browser while Codex or Claude Code reads and writes the same page through MCP, adding images, diagrams, and slide decks.

Mindmap

mindmap
  root((Cowrite))
    What it does
      Browser writing canvas
      Agent edits same page
      Local only, no upload
    Tech stack
      TypeScript
      Node.js
      MCP protocol
    Use cases
      Draft articles with an agent
      Add illustrations and diagrams
      Export to slide decks
      Post to WeChat or Xiaohongshu
    Audience
      Codex users
      Claude Code users
      Writers using AI agents

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

Write and edit an article in the browser while an AI agent drafts and revises it through the same connection.

USE CASE 2

Turn a finished article into an editable slide deck with a matching PDF preview.

USE CASE 3

Generate illustrations or HTML diagrams for a passage without leaving the writing canvas.

USE CASE 4

Format an article for WeChat's official account style or for Xiaohongshu and send it out through Feishu.

What is it built with?

TypeScriptNode.jsMCPnpmVite

How does it compare?

spacezephyr/cowritedavidichalfyorov-wq/openxivgenie-sa/genie-react
Stars333333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity2/55/53/5
Audiencevibe coderresearcherdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node.js 20.19+ and a working Codex CLI or Claude Code install, first load auto-builds the frontend.

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

In plain English

Cowrite is a writing tool that runs entirely on your own computer. It gives you a browser window where you write and edit articles, while an AI coding assistant like Codex or Claude Code reads and writes the same document through a connection called MCP. The two sides share one file, so you can keep typing while the assistant works on the same page. The main idea is that you type a request inside the assistant's chat, and the article grows and updates inside the browser. You can start a new page by filling in a title and instructions, or by importing an existing Markdown file. You can paste images straight into the editor and Cowrite stores them in a local folder instead of turning them into long text strings that would slow the page down. Once a page is open, a floating toolbar lets you select text and ask for an illustration, an HTML diagram, a rewrite of just that passage, or a conversation about the content. There are also buttons for turning an article into a slide deck (an editable PPTX file plus a browser viewable PDF), for formatting it for WeChat's official account style or Xiaohongshu, a Chinese social platform, and for sending the finished piece out through Feishu, a document tool. Sending to WeChat and Zhihu is marked as not finished yet. All image generation goes through a built in tool inside Codex, so no separate image API key is needed, and the project does not switch to other image services if that tool is unavailable. Cowrite needs Node.js 20.19 or newer (or 22.12 or newer) and npm, plus a working Codex CLI or Claude Code install. Setup happens automatically the first time the plugin loads: it installs dependencies, builds the front end, and starts a local service that only listens on your own machine, so nothing is uploaded anywhere. It also ships as a plugin for both Codex and Claude Code with a marketplace listing you can add directly. The license is MIT.

Copy-paste prompts

Prompt 1
Set up Cowrite locally with Claude Code and start the writing canvas.
Prompt 2
Import my draft Markdown file into Cowrite and suggest a title.
Prompt 3
Use Cowrite to generate 3 to 4 illustrations for this article in a consistent style.
Prompt 4
Convert this Cowrite article into an editable PPTX slide deck.
Prompt 5
Reformat this article for WeChat's official account layout using Cowrite.

Frequently asked questions

What is cowrite?

A local writing canvas where you edit articles in the browser while Codex or Claude Code reads and writes the same page through MCP, adding images, diagrams, and slide decks.

What language is cowrite written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does cowrite use?

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

How hard is cowrite to set up?

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

Who is cowrite for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.