Skip to content

shlomihod/ezra

Repository files navigation

Ezra

Research Preview — This is an experimental prototype. Expect breaking changes and rough edges. Not security-hardened; designed for local use only. Feedback welcome via GitHub Issues.

AI document review with tracked changes and comments. A Claude Code plugin that gives Claude a rich-text editor with tracked changes and threaded comments.

What It Does

Ezra provides Claude with MCP tools to review, edit, and annotate documents in a browser-based editor:

  • Tracked changes — suggest insertions and deletions the user can accept or reject
  • Comment threads — anchor comments to specific text, reply, and resolve
  • Direct edits — make immediate changes when appropriate
  • Live browser UI — all changes appear in real-time at http://localhost:3333

Usage

/review Consulting Agreement — check for legal issues
/workshop Consulting Agreement

Install as Claude Code Plugin

/plugin marketplace add shlomihod/ezra
/plugin install ezra@ezra

Requirements

Ezra requires Node 22+ and npm. On first MCP spawn the plugin runs npm ci and builds the server with tsc — this takes roughly 20–40 s on a typical link. Subsequent spawns are instant.

Manual Setup

git clone https://github.com/shlomihod/ezra.git
cd ezra
npm ci
npm run build

Then from your project directory:

claude --plugin-dir /path/to/ezra

For the local HTTP-server entrypoint (node bin/ezra.js), run npm run build at the repo root first to populate client/dist/.

MCP Tools

Tool Description
ezra_list List all documents
ezra_open Open a document in the browser
ezra_read Read document content with line numbers
ezra_edit Direct text replacement
ezra_write Overwrite entire document
ezra_suggest Propose a tracked change for review
ezra_comment Add a comment anchored to text
ezra_reply Reply to a comment thread
ezra_resolve Resolve a comment thread
ezra_accept Accept a tracked change
ezra_reject Reject a tracked change
ezra_create Create a new document
ezra_duplicate Duplicate a document
ezra_import Import content as a new document
ezra_threads Query comment threads
ezra_changes_since Poll for recent operations

Development

npm run dev:server   # server with hot reload (tsc -w & node --watch)
npm run dev:client   # Vite dev server
npm test             # unit tests (server + client)
npm run test:e2e     # Playwright end-to-end tests

About

AI document review with tracked changes and comments. A Claude Code plugin that gives Claude a rich-text editor with tracked changes and threaded comments.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages