Sobre o projeto

OfficeCLI é uma ferramenta de linha de comando de código aberto e binário único para ler, editar, criar e automatizar arquivos Word (.docx), Excel (.xlsx) e PowerPoint (.pptx). Não requer instalação do Office e incorpora seu próprio runtime .NET, portanto funciona em macOS, Linux e Windows, incluindo contêineres headless e ambientes de CI. Seu foco declarado são agentes de IA: um arquivo de skill pode ser obtido com um único comando curl para que um agente aprenda a instalar o binário e usar seus comandos. Um mecanismo de renderização HTML integrado converte documentos em HTML ou PNG por página, dando aos agentes multimodais uma forma de inspecionar a saída renderizada e iterar. Um comando `watch` serve uma pré-visualização local com atualização automática em localhost:26315, e o watch do Excel suporta edição de células inline e reposicionamento de gráficos. Os recursos principais abrangem três camadas: visualizações de alto nível (`view` com modos text, annotated, outline, stats, issues, html, svg, screenshot), operações DOM estruturadas (`get`, `query`, `set`, `add`, `remove`, `move`, `swap`) e acesso XML bruto (`raw`, `raw-set`, `add-part`, `validate`). Documentos podem ser endereçados com seletores de caminho como `/slide[1]/shape[1]`, e os resultados podem ser retornados como JSON estruturado. Recursos específicos de formato incluem suporte a i18n e RTL no Word, parágrafos, runs, tabelas, estilos, caixas de texto, cabeçalhos/rodapés, imagens, equações LaTeX, diagramas mermaid, comentários, notas de rodapé, marcas d'água, indicadores, TOC, gráficos, hiperlinks, seções, campos de formulário, controles de conteúdo, campos, objetos OLE e alterações controladas. O suporte ao Excel cobre células, mais de 350 fórmulas autoavaliadas, incluindo matrizes dinâmicas, planilhas, tabelas, classificação, formatação condicional, gráficos, tabelas dinâmicas, segmentações de dados, intervalos nomeados, validação de dados, imagens, minigráficos, comentários, autofiltro, formas e importação CSV/TSV. O suporte ao PowerPoint cobre slides, formas, imagens, tabelas, gráficos, animações, transições, modelos 3D .glb, zoom de slide, equações, diagramas, temas, conectores, vídeo/áudio, grupos, notas, comentários, SmartArt, objetos OLE e placeholders. Mecanismos adicionais incluem um mecanismo de fórmulas e tabelas dinâmicas que grava tabelas dinâmicas OOXML nativas, um comando de mesclagem de modelos que preenche placeholders {{key}} a partir de JSON em parágrafos, células, formas, cabeçalhos, rodapés e títulos de gráficos, e um dump/batch round-trip que serializa um documento ou subárvore em JSON reproduzível. O modo residente mantém um documento na memória para edições em várias etapas com baixa latência, e o modo batch aplica várias operações atomicamente com rollback em caso de falha. As opções de integração incluem um servidor MCP integrado registrável para Claude Code, Cursor, VS Code/Copilot e LM Studio, além de instalação via script curl, Homebrew, Scoop, npm ou binários de release diretos. Um aplicativo desktop complementar, AionUi, oferece criação de documentos em linguagem natural sobre o OfficeCLI. O projeto é licenciado sob Apache 2.0.