docx-trackdiff

Compare two Word documents (.docx) and get a native Track Changes redline — as if a human editor had revised the old draft into the new one with "Track Changes" switched on. One command in, one verified tracked-changes .docx out.

• ✍️ A working document, not a report — real <w:ins> / <w:del> revisions with unique IDs, author, and date; accept or reject each change individually in Word, WPS, or LibreOffice
• 🔍 Word-level precision — modified paragraphs get fine-grained inline diffs (12% → 1218%), not crude whole-paragraph replace
• 🖼️ Lossless in both directions, images included — a replaced figure keeps the old image's original bytes inside its deletion mark, so "reject change" truly restores the old picture
• ✅ Every output machine-verified — the bundled verifier runs 7 automated checks: simulated accept all must equal the new file, simulated reject all must equal the old file, plus structural checks
• 🪶 Radically lightweight — pure Python + lxml; no runtimes, no SDKs, no prebuilt binaries
• 🔒 Private by default — 100% local, no upload, no network call

Install

pip install docx-trackdiff

Usage

# 1. Generate the tracked-changes document
docx-trackdiff OLD.docx NEW.docx OUTPUT.docx --author "Your Name"

# 2. Verify (7 automated checks)
docx-trackdiff-verify OUTPUT.docx OLD.docx NEW.docx

Open OUTPUT.docx in Word → Review tab → All Markup. Accept or reject each change individually.

Options

Links

• GitHub: https://github.com/stephenlzc/docx-trackdiff
• Evaluation report: https://github.com/stephenlzc/docx-trackdiff/blob/main/EVALUATION.md

MIT licensed. Built with Kimi K3 Agent Swarm by Moonshot AI.