nuncaeslupus/doc-control

> Status: **file engine working** (pre-1.0; the API may still change). The live engine
> drives LibreOffice Writer and Microsoft Word (Windows). See status/specification.md and status/plan.md.
A deterministic tool that lets AI agents work on Word documents quickly,
precisely and safely, ideally live in the Word window the writer has open.
Every content change is a tracked change the writer can accept or reject.
For anyone — writers and editors first — who wants an AI agent's help inside a
Word document without a single silent change.
Install without Python (Windows)
No Python needed. Every release on the latest release page
carries a Claude Desktop extension and an installer. Both install for the current Windows
user only, need no admin rights, and work with any Claude account, the free plan included.
They drive Microsoft Word live; LibreOffice live control still needs the Python install
below. The full guide (checksums, updates, uninstalling, moving from uvx) is
docs/install-windows.md.
Claude Desktop extension (.mcpb)
1. Download doc-control-X.Y.Z-windows-x64.mcpb from the latest release.
2. Drag the file onto Claude Desktop's **Settings > Extensions** page and click **Install**.
Claude Desktop then warns, in red, that the extension can access everything on your
computer. Every local extension gets that warning; it is expected. Double-clicking the
file does not install it: Windows only asks which program should open it.
Installer (-setup.exe), for the command line
1. Download doc-control-X.Y.Z-windows-x64-setup.exe from the latest release.
2. Double-click it.
3. If Windows SmartScreen says "Windows protected your PC", click **More info**, then **Run anyway** (the installer is not code-signed).
4. Click **Install**, **Next** and **Finish**, and open a new terminal: doc-control server.capabilities works there.
To update, install the newer release the same way. To uninstall, remove the extension
from **Settings > Extensions**, or the installer's copy from Windows **Settings > Apps**
("doc-control X.Y.Z"). A winget package is coming.
Usage
Install with pip install doc-control (or run it without installing: uvx doc-control).
Python 3.11+, no other dependencies. To drive the Word that is open on Windows, install
doc-control[live] (it adds pywin32); LibreOffice needs no extra package.
Command line, JSON in and JSON out:
Every write is a tracked change by DOC_CONTROL_AUTHOR (default Claude), made after a
backup and verified, with history.undo and history.* to go back. Addresses like
p12#a7b2a7b2 come from read results and fail loudly if the paragraph changed.
One edit can also go straight to its own operation (text.replace, para.insert,
para.delete, comment.add, revision.accept, revision.reject), which runs it as a
one-edit doc.batch.
For a change the writer has already approved in the chat, batch, term.rename and
restore take "tracked": false: the same edit with this call's own revisions accepted in
the same verified write, so no revision mark is left (other tracked changes stay; a paragraph
that holds one is refused). Tracked stays the default. undo of a plain write restores the
backup, so it works only while the document is exactly as that write left it (later edits must
be undone first; otherwise BATCH_CONFLICT). A plain edit inside a tracked-inserted table row is
allowed; rejecting that row later removes the plain text too. File engine only for now.
From Python, a document can be held open for many reads, with whole results:
Recipes propose batches of fixes (Spanish typography, quotes, dashes, spacing, empty
paragraphs and more): recipe.list, then recipe.run returns a batch to review and apply.
Notes, headers, footers and tables
Reads cover the body only unless asked; stories opts in to the rest ("notes" for