OfficeCLI — The First Office Suite Built for AI Agents
If you’ve ever tried to get an AI agent to edit a PowerPoint deck, you know the pain. Python-pptx scripts that balloon to 50+ lines for a simple text change. Fragile coordinate math. No way to preview what you’re building. And forget about doing it without a full Python environment.
OfficeCLI changes all of that. It’s the world’s first Office suite designed from the ground up for AI agents — a single binary that lets any agent read, edit, and create Word, Excel, and PowerPoint files directly from the command line.
Why AI Agents Need Their Own Office Suite
Today’s AI coding agents — Claude Code, Cursor, Windsurf — are great at writing code. But the moment you ask them to modify a .pptx or .xlsx file, they hit a wall. They either need Microsoft Office installed (which most CI/CD and cloud environments don’t have), or they resort to bloated Python libraries with complex APIs that waste tokens and introduce bugs.
OfficeCLI solves this with a radically simple approach: every document element gets a path, and every command returns structured JSON.
Want to change the title on slide 1? One command:
officecli pptx set presentation.pptx '/slide[1]/shape[1]/text' "New Title"
That’s it. No imports, no boilerplate, no coordinate systems. The path-based addressing (/slide[1]/shape[1]) makes documents as navigable as a file system.
Key Features That Matter
Zero dependencies, single binary. Download it, run it. No Microsoft Office, no Java, no Python. Works on macOS, Linux, and Windows.
Structured JSON output. Every command returns parseable JSON, which is exactly what AI agents need. No scraping stdout, no regex parsing — just clean data.
Resident mode. For batch edits, OfficeCLI keeps documents in memory so you’re not re-reading and re-writing the file on every operation. This is a game-changer for agents making dozens of edits in sequence.
Live preview. Run officecli watch and get a browser-based hot-reloading preview of your document as the agent edits it. You can literally watch the AI work in real time.
Built-in AI agent integration. OfficeCLI ships with a SKILL.md file that teaches Claude Code, Cursor, and Windsurf how to use it. Run officecli install and it auto-detects your AI coding agent and installs the skill. The agent immediately knows every command.
Beyond the CLI: AionUi
OfficeCLI also includes AionUi, a GUI desktop application for natural language document editing. Think of it as a bridge between non-technical users and the power of OfficeCLI — you describe what you want in plain English, and AionUi handles the rest.
The Numbers
The feature set is comprehensive:
- 150+ Excel functions including VLOOKUP, INDEX/MATCH, and array formulas
- Charts and pivot tables in Excel
- Full i18n and RTL support for international documents
- Word, Excel, and PowerPoint — the full Office trifecta
- Apache 2.0 license — use it anywhere, commercially or otherwise
Who Should Use OfficeCLI
- AI agent developers building workflows that touch Office documents
- DevOps teams generating reports in CI/CD pipelines
- Developers who want to script document creation without heavyweight libraries
- Anyone who’s written 50 lines of python-pptx and wished there was a better way
Getting Started
# Install (macOS)
brew install iofficeai/tap/officecli
# Read a presentation
officecli pptx get presentation.pptx '/slide[1]'
# Edit a cell in Excel
officecli xlsx set report.xlsx '/sheet[1]/cell[A1]' "Revenue: $1M"
# Watch live preview
officecli watch presentation.pptx
Check out the GitHub repository for full documentation and examples.
Frequently Asked Questions
Do I need Microsoft Office installed to use OfficeCLI?
No. OfficeCLI is a standalone binary with zero dependencies. It reads and writes Office file formats (.docx, .xlsx, .pptx) natively without requiring Microsoft Office or any other software.
Which AI coding agents does OfficeCLI support?
OfficeCLI ships with built-in support for Claude Code, Cursor, and Windsurf. The officecli install command auto-detects your agent and installs a SKILL.md file that teaches it every available command.
Is OfficeCLI free to use?
Yes. OfficeCLI is released under the Apache 2.0 license, which means it’s free for both personal and commercial use.
What’s the difference between OfficeCLI and python-pptx?
OfficeCLI is a single binary with path-based addressing and JSON output — designed for AI agents and automation. Python-pptx is a Python library that requires writing procedural code. Tasks that take 50+ lines in python-pptx often take a single OfficeCLI command.
What is resident mode?
Resident mode keeps a document loaded in memory across multiple commands, eliminating the overhead of reading and writing the file for each edit. This is especially useful for AI agents performing batch operations.
Does OfficeCLI support Excel formulas?
Yes. OfficeCLI supports over 150 Excel functions including VLOOKUP, INDEX/MATCH, SUMIF, array formulas, charts, and pivot tables.