OfficeCLI: The AI-Native CLI for Word, Excel, and PowerPoint Automation

Summary

OfficeCLI is a free, open-source command-line interface designed for AI agents and developers to read, edit, and automate Word, Excel, and PowerPoint files. It operates as a single binary, requiring no Office installation or dependencies. With its built-in rendering and formula engines, OfficeCLI enables high-fidelity document manipulation and visualization in headless environments.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

OfficeCLI is the world's first and best Office suite specifically designed for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. This free, open-source command-line interface operates as a single binary, requiring no Microsoft Office installation or external dependencies. It empowers AI agents and developers to gain full control over document manipulation with simple, powerful commands.

A key feature of OfficeCLI is its built-in HTML rendering engine, which reproduces documents with high fidelity. This allows AI agents to "see" the rendered document, enabling a crucial render, look, and fix loop for precise adjustments, even in headless or containerized environments.

Installation

Getting started with OfficeCLI is straightforward, thanks to its self-contained binary.

One-line install for macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

One-line install for Windows (PowerShell):

irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

Alternatively, you can download the binary for your specific platform directly from the GitHub Releases page. After downloading, simply run officecli install to set it up and integrate it with detected AI coding agents.

Examples

OfficeCLI simplifies complex document tasks into concise commands. Here's a quick start to create and modify a PowerPoint presentation:

1. Create a blank PowerPoint:

officecli create deck.pptx

2. Start live preview (opens in your browser):

officecli watch deck.pptx

3. In another terminal, add a slide and watch the browser update instantly:

officecli add deck.pptx / --type slide --prop title="Hello, World!"

4. Get structured JSON for an element:

officecli get deck.pptx '/slide[1]' --json

This provides a clear, machine-readable output for easy integration into automated workflows.

Why Use OfficeCLI?

OfficeCLI offers unique advantages for both AI agents and human developers:

AI-Native Design: Provides deterministic JSON output, path-based addressing, and a progressive complexity model (L1: Read, L2: DOM, L3: Raw XML) that minimizes token usage for AI agents.
Built-in Rendering Engine: Allows AI agents to visualize their output with view html, view screenshot, or watch, enabling self-correction of layout issues without needing Microsoft Office.
Powerful Document Automation: Automate report generation, batch-process documents, build CI/CD document pipelines, and perform headless Office automation in Docker environments.
Comprehensive Functionality: Supports creating, reading, modifying, analyzing, and reorganizing content across Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files.
Advanced Features: Includes a built-in formula and pivot engine for Excel, template merging for {{key}} placeholders, and a round-trip dump command to learn from existing documents.
Cross-Platform & Zero-Install: Ships as a single, self-contained binary for macOS, Linux, and Windows, embedding the .NET runtime so there's nothing else to install.

Compared to traditional methods, OfficeCLI streamlines document manipulation, making it highly efficient for modern AI-driven and automated workflows.