Draftwatch

Review an AI’s edits to your writing the way you’d review a pull request.

View on GitHub Install

AI agents are good at editing prose and bad at telling you what they did. Ask one to tighten a draft and you get back a wall of new text plus a summary of changes that may or may not be complete. Draftwatch closes that gap: it is a lightweight IDE for writers that shows the exact, git-backed word diff of what changed in a file, lets you keep or revert each change, and commits when you’re done.

The diff comes from git on your machine, not from the AI vendor and not from a JavaScript approximation. You get independent verification of what the agent actually did.

Draftwatch reviewing an agent’s edits: your working text on the left in a real editor, the word diff against your baseline on the right. Click any change to revert it.

How it works

Run Draftwatch from inside any git repository you write in, pointed at the file your agent is editing:

draftwatch draft.md

It opens a two-panel review window: your source on the left (with markdown highlighting, search, and a live preview), the diff against your baseline on the right. The baseline is switchable, so you can diff against your last push, HEAD, or an earlier commit. Review the changes, revert the ones you don’t want, apply, then commit. Committing advances the baseline, so the next agent pass starts clean.

You and the agent can both edit at the same time; your unsaved work is never clobbered when the file changes on disk. For long documents you can jump between changes or collapse to a changes-only view.

Install

Draftwatch

Draftwatch is a lightweight IDE for writers. You can use it to create and format new Markdown documents from scratch, or use it to review an AI agent’s edits to your writing exactly the way a developer reviews a pull request.

When reviewing AI edits, instead of guessing what an LLM changed in your document, Draftwatch shows you the exact, git-backed word-diff. You can step through, keep or revert each change individually, and commit when you’re done.

Crucially, the diff comes from your local git—not from the AI vendor and not from a JavaScript approximation. You get absolute, independent verification of what the agent or script actually did.

Python 3.9+ and git are the only requirements. The front-end libraries (CodeMirror 6, marked, DOMPurify, Turndown) are vendored and served locally, so Draftwatch works completely offline and binds to localhost only.

Install

Draftwatch is available on PyPI. You can install or run it using your preferred Python package manager:

# pipx
pipx install draftwatch

# uv 
uv tool install draftwatch

# standard pip
pip install draftwatch

Built for trust

Draftwatch binds to localhost only, validates every request against a per-session token, and sanitizes the markdown preview before rendering. The front-end libraries are vendored and served locally, so it works offline. The tool never talks to any LLM: it watches your files and reads your git history, nothing else.

Draftwatch is open source under the MIT license. Code, issues, and releases are on GitHub.