{
  "markdown": "# Safe Docx\n\nEdit Word and OpenDocument files with coding agents.\n\n<!-- SYNC:badges BEGIN -->\n[![CI](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml/badge.svg)](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml)\n[![codecov](https://img.shields.io/codecov/c/github/usejunior/safe-docx/main)](https://app.codecov.io/gh/usejunior/safe-docx)\n[![npm version](https://img.shields.io/npm/v/@usejunior/safe-docx)](https://www.npmjs.com/package/@usejunior/safe-docx)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache--2.0-green.svg)](https://github.com/UseJunior/safe-docx/blob/main/LICENSE)\n[![GitHub last commit](https://img.shields.io/github/last-commit/UseJunior/safe-docx)](https://github.com/UseJunior/safe-docx/commits/main)\n[![GitHub issues closed](https://img.shields.io/github/issues-closed/UseJunior/safe-docx)](https://github.com/UseJunior/safe-docx/issues?q=is%3Aissue+is%3Aclosed)\n<!-- SYNC:badges END -->\n\n<!-- SYNC:lang-nav BEGIN -->\n[English](./README.md) · [Español](./README.es.md) · [简体中文](./README.zh.md) · [Português](./README.pt-br.md) · [Deutsch](./README.de.md)\n<!-- SYNC:lang-nav END -->\n\nSafe Docx is a local MCP server and CLI for reading, searching, editing, comparing, converting, and saving document files. It preserves DOCX structure and can produce clean or tracked-changes output.\n\n## Example\n\nAsk your coding agent:\n\n```text\nEdit NDA.docx. Change the governing law from New York to Delaware.\nSave a clean copy and a tracked-changes copy. Do not change anything else.\n```\n\nSafe Docx finds the clause, applies the targeted edit, and writes both files for review. The rest of the document stays outside the requested edit.\n\nFollow the complete [editing walkthrough](docs/tutorial.md).\n\n## Comparisons\n\n- [SuperDoc](docs/comparisons.md#superdoc)\n- [Claude's built-in DOCX editing](docs/comparisons.md#claudes-built-in-docx-editing)\n- [python-docx](docs/comparisons.md#python-docx)\n- [DOCX compatibility matrix](docs/comparisons.md#compatibility-matrix)\n\n## Install\n\n```bash\nnpm install --global @usejunior/safe-docx\n```\n\nThen configure your MCP client with the installed executable's absolute path. For Claude Code:\n\n```bash\nclaude mcp add safe-docx -- /absolute/path/to/safe-docx\n```\n\n### Antigravity CLI\n\nAdd Safe Docx to `~/.gemini/config/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"safe-docx\": {\n      \"command\": \"/absolute/path/to/safe-docx\",\n      \"args\": []\n    }\n  }\n}\n```\n\nRestart `agy`, then ask it to edit a `.docx` file. Antigravity may ask you to approve the MCP server before first use.\n\nSee [Installation and verification](docs/installation.md) for locating the executable, pinning a version, and configuring clients.\n\n## Documentation\n\n- [Installation and verification](docs/installation.md)\n- [Tool reference](packages/docx-mcp/docs/tool-reference.generated.md)\n- [TypeScript library](packages/docx-core/README.md)\n- [Architecture](docs/architecture.md)\n- [Testing and evidence](docs/testing-and-evidence.md)\n- [Trust and conformance](docs/trust-and-conformance.md)\n- [Contributing](CONTRIBUTING.md)\n\n## Standards Conformance\n\nBrowse the [Safe Docx Conformance Explorer](https://usejunior.com/engineering/safe-docx/conformance) to navigate ECMA-376 sections, OOXML schema declarations, capability claims, explicit non-goals, and measured cross-implementation outcomes.\n\nThe generated [repository conformance report](spec-compliance/CONFORMANCE.md) remains the source-controlled record of targeted sections, non-goals, and verification references.\n\n## What Safe Docx Is Not Optimized For\n\nSafe Docx is not a visual editor or layout engine. It does not provide browser rendering, real-time collaboration, or pixel-level pagination guarantees. `.dotx` templates must be converted to `.docx` before use.\n",
  "bytes": 3795,
  "sha": "2cc6b6983a688a8e5d4e929906f8d6cafa7b8bb75c32281bd6915a9750941715",
  "repo_slug": "usejunior/safe-docx",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_usejunior_safe_docx_5fb751f3/readme"
}