docx-cli
MIT-licensed CLI and agent skill that lets Claude, Codex, Pi, and other coding agents read, redline, comment on, render, and safely edit Word .docx files.
Do not bounce yet
Read the fit check, compare one alternative, then decide whether the vendor page is still your best next click.
Quick Verdict
Fast fit check before you leave the page
Make the fit call first. Vendor pages are good at selling, but they rarely tell you where the product is a bad match.
- Developers using Claude Code, Codex, Pi, or Agent Skills-compatible agents on Word-document workflows
- Teams that need agents to redline contracts, specs, rubrics, invoices, or handoff documents without corrupting .docx files
- Agent builders looking for tool-specific affordances that make weaker or cheaper models more reliable
- It is document tooling, not a coding-agent harness, so it is only valuable when .docx fidelity is part of the workflow.
- The project is young despite fast iteration, and teams should test difficult corporate templates before trusting it for high-stakes documents.
- Some rendering and verification paths still depend on local Word or LibreOffice availability, which can vary across developer machines and CI runners.
Compare Next
Take one more internal step before the vendor pitch
This is where visitors usually jump out too early. Read one deeper take or open one alternative so the next click is informed instead of impulsive.
Alternative profile
Google Agents CLI
Google open-source CLI and skill bundle that teaches Claude Code, Codex, Antigravity, and other coding agents to build, evaluate, deploy, and publish ADK agents on Google Cloud.
Alternative profile
jcode
Rust-based coding-agent harness with a native TUI, multi-session workflows, agent memory, swarm coordination, MCP, browser tooling, and broad model-provider support.
Alternative profile
ctx
Open-source local CLI that indexes coding-agent transcripts from Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Copilot CLI, and related harnesses for cited history search.
docx-cli is worth tracking because agent workflows increasingly touch more than source code. Contracts, specs, rubrics, invoices, and customer handoff documents still live in Word, and asking a model to unzip a .docx and hand-edit OOXML is exactly the kind of clever shortcut that creates corrupted files. docx-cli gives agents a narrow command surface for reading, redlining, commenting on, rendering, and safely editing Word documents while preserving the human review loop inside Word.
docx-cli is a Word-document tooling layer for agent workflows that need reliable file edits instead of brittle OOXML prompt hacking. It gives Claude, Codex, Pi, and other skill-aware coding agents stable document locators, annotated Markdown and JSON AST read views, native tracked changes, comments, table and image operations, render-based visual verification, and in-place XML mutation that preserves formatting. That makes it relevant to vibe-coding teams whose agents need to update contracts, specs, rubrics, invoices, or handoff documents without corrupting Word files or burning unnecessary tokens.
Why Choose docx-cli?
Choose docx-cli when a Claude, Codex, Pi, or Agent Skills-compatible workflow needs to edit .docx files without losing formatting or producing documents Word cannot open.
The strongest fit is agent-assisted document work where tracked changes, comments, stable locators, and render verification matter more than raw text generation.
It is also useful for teams trying to reduce token waste, because agents can operate through document commands and annotated read views instead of reasoning over raw OOXML.
Be careful with scope. docx-cli is a document-fidelity tool for agents, not a general-purpose coding assistant or document management system.
Key Features
Stable locators such as pN, tN, comments, images, links, footnotes, and tracked-change ids so agents can address exact Word-document spans without rewriting raw OOXML.
Read modes that expose a .docx document as annotated Markdown or a JSON AST while preserving structural details that ordinary Markdown cannot represent.
Native tracked changes, comments, accept/reject flows, redlines, paragraph edits, table operations, image operations, hyperlinks, equations, headers, footers, styles, and list numbering.
In-place XML mutation designed to preserve untouched formatting, theme colors, embedded objects, relationships, and document structure instead of re-emitting the whole file from a model.
Render command that can drive Word or LibreOffice and rasterize pages so agents can visually verify document edits before handoff.
Ships as a portable Agent Skill and plugin path for Claude Code, Codex, Pi, and other harnesses that consume skill directories.
Prebuilt standalone binaries for macOS, Windows, and Linux, plus npm/Bun install paths and release checksums.
Pros & Cons
- It targets a real agent workflow failure: Word files are easy for agents to corrupt when they manipulate ZIP/XML internals directly.
- The benchmark and eval materials are unusually concrete for a small tool, comparing task completion, render correctness, token use, and wall-clock time against default agent document editing.
- Codex, Claude Code, Pi, and generic skill support make it useful across multiple coding-agent environments rather than one vendor UI.
- Tracked changes and comments fit human review habits, so agent edits stay reviewable inside Word instead of becoming opaque generated files.
- It is document tooling, not a coding-agent harness, so it is only valuable when .docx fidelity is part of the workflow.
- The project is young despite fast iteration, and teams should test difficult corporate templates before trusting it for high-stakes documents.
- Some rendering and verification paths still depend on local Word or LibreOffice availability, which can vary across developer machines and CI runners.
- The public adoption signal is still early: HN discussion and GitHub traction are good for launch week, but production usage numbers are not available.
Detailed Use Cases for docx-cli
Turn on track changes, let the agent make scoped edits through docx-cli, and hand the resulting .docx back to a human reviewer who can accept, reject, or reply in Word.
Use paragraph, table, image, hyperlink, comment, and tracked-change locators so an agent can target exact spans instead of regenerating the whole document.
The CLI mutates the existing XML tree in place, which helps preserve custom styles, theme colors, relationships, tables, images, headers, and footers that generic Markdown round-trips usually lose.
Use docx render to produce page images through Word or LibreOffice so agents can inspect whether a document still opens and lays out correctly before returning it.
Who Should Use docx-cli?
Developers using Claude Code, Codex, Pi, or Agent Skills-compatible agents on Word-document workflows
Teams that need agents to redline contracts, specs, rubrics, invoices, or handoff documents without corrupting .docx files
Agent builders looking for tool-specific affordances that make weaker or cheaper models more reliable
Operations and legal-adjacent teams that want AI-generated edits to remain reviewable as Word tracked changes and comments
Perfect For
Let a coding agent update requirements docs, contracts, rubrics, invoices, or handoff documents while preserving Word formatting and review metadata.
Use tracked changes and comments so a human can accept, reject, or reply to agent-authored Word edits in the normal Microsoft Word review flow.
Give weaker or cheaper agents structured document commands instead of asking them to reason about raw OOXML.
Render edited .docx files to page images so an agent can verify layout and formatting before returning the result.
Technical Details
docx-cli Comparisons & Alternatives
docx-cli review
docx-cli vs Microsoft Word automation
docx-cli vs LibreOffice CLI
Claude Code docx editing
Codex docx editing
agent safe Word editing
AI agent tracked changes
Word document CLI for agents
Developers compare docx-cli with other vibe coding tools when they need a better workflow fit, not just a better landing page.
Direct Competitors
python-office-mcp-server
smalldocs
Microsoft Word automation scripts
LibreOffice headless CLI
manual OOXML editing
Similar Tools You Might Like
Google open-source CLI and skill bundle that teaches Claude Code, Codex, Antigravity, and other coding agents to build, evaluate, deploy, and publish ADK agents on Google Cloud.
Rust-based coding-agent harness with a native TUI, multi-session workflows, agent memory, swarm coordination, MCP, browser tooling, and broad model-provider support.
Open-source local CLI that indexes coding-agent transcripts from Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Copilot CLI, and related harnesses for cited history search.
Do one more comparison before you commit to docx-cli
Strong picks usually survive one more internal check. Read deeper, compare a neighbor, then leave for the vendor page if the fit still holds.