# docx-cli

> A CLI tool that enables AI agents like Claude and Codex to read, edit, and comment on .docx files with full format fidelity.

docx-cli is an open-source command-line interface built in TypeScript that gives AI agents — including Claude and OpenAI Codex — the ability to interact with Microsoft Word (.docx) files while preserving full formatting. Created by Kirill Klimuk and released under the MIT License, the project is actively maintained with its latest release (v0.20.1) published in July 2026.

## What It Is

docx-cli is a CLI skill layer designed to bridge AI coding agents and the OOXML-based .docx file format. Rather than stripping documents to plain text, it exposes structured read, edit, and comment operations that maintain the rich formatting Word documents rely on — styles, tracked changes, comments, and layout. It is positioned as an "agent skill" that can be plugged into agentic workflows powered by tools like Claude Code or Codex.

## How It Works

The tool operates as a command-line binary that agents invoke to perform document operations. Because it targets the OOXML specification directly, it can handle the full complexity of .docx internals — paragraph styles, runs, tables, and revision markup — without lossy round-trips through plain text. This makes it suitable for tasks like drafting, reviewing, and annotating Word documents programmatically inside an AI agent loop.

## Agent Skill Design

docx-cli is explicitly tagged as an agent skill for Anthropic's Claude (including Claude Code) and OpenAI Codex. This framing means it is intended to be registered as a callable tool within an agent's skill registry, letting the agent decide when to invoke document operations as part of a larger task. The repository topics include `agent-skills`, `claude-skill`, and `anthropic-skills`, reflecting this integration-first design philosophy.

## Current Status: v0.20.1

The project reached v0.20.1 on July 8, 2026, indicating rapid iteration since its creation in May 2026 — more than 20 minor releases in roughly two months. The repository has 125 stars and 7 forks with zero open issues, suggesting an active but focused early-stage project. The MIT license makes it freely usable and redistributable without restriction.

## Features
- Read .docx files with full format fidelity
- Edit .docx files programmatically
- Add comments to .docx files
- OOXML-native document manipulation
- Designed as an agent skill for Claude and Codex
- TypeScript implementation
- MIT licensed open-source

## Integrations
Claude Code, Anthropic Claude, OpenAI Codex

## Platforms
API, CLI

## Pricing
Open Source

## Version
v0.20.1

## Links
- Website: https://github.com/kklimuk/docx-cli
- Repository: https://github.com/kklimuk/docx-cli
- EveryDev.ai: https://www.everydev.ai/tools/docx-cli