AI 에이전트가 워드, 엑셀, 파워포인트를 직접 보고 수정하는 단일 바이너리 도구
AI 에이전트가 문서 레이아웃을 눈으로 확인하고 오류를 스스로 수정하는 장면을 상상해 보세요. OfficeCLI는 AI 에이전트가 워드, 엑셀, 파워포인트 파일을 읽고, 수정하며, 자동화할 수 있도록 설계된 오픈소스 도구입니다. 마이크로소프트 오피스 설치 없이 단일 바이너리로 동작하며, AI가 생성한 문서를 실시간으로 미리보기로 검증할 수 있습니다.
AI의 눈이 되는 내장 렌더링 엔진
AI 에이전트가 문서를 생성할 때 가장 큰 장벽은 결과물을 시각적으로 확인하지 못한다는 점입니다. OfficeCLI는 이 문제를 해결하기 위해 고해상도 HTML 렌더링 엔진을 바이너리 내부에 직접 포함했습니다. 이 엔진은 .docx, .xlsx, .pptx 파일을 HTML이나 PNG 이미지로 변환하여 AI가 제목이 넘치는지, 도형이 겹치는지 등을 판단할 수 있게 합니다. 덕분에 '렌더링 → 확인 → 수정'이라는 루프가 서버나 컨테이너 환경에서도 끊김 없이 작동합니다. 오피스 소프트웨어가 설치되지 않은 헤드리스 환경에서도 AI가 자신의 출력을 검증하고 레이아웃 문제를 즉시 해결할 수 있습니다.
복잡한 코드를 한 줄 명령으로
기존에는 파이썬 라이브러리를 여러 개 조합해 수십 줄의 코드를 작성해야 했던 문서 조작을 OfficeCLI는 단순한 명령어로 처리합니다. 예를 들어 파워포인트에 슬라이드를 추가하고 텍스트를 넣는 작업은 officecli add 명령 하나로 끝납니다. 모든 명령은 일관된 JSON 형식으로 출력을 지원하여 AI 에이전트가 결과를 쉽게 파싱할 수 있게 합니다. 또한 문서 내 모든 요소에 안정적인 경로를 부여해 AI가 XML 네임스페이스를 이해하지 않아도 문서를 탐색하고 수정할 수 있습니다. 오류 발생 시에도 구조화된 오류 코드와 수정 제안을 반환해 AI가 스스로 문제를 해결하도록 돕습니다.
템플릿 병합과 실시간 미리보기
반복적인 보고서 생성을 위해 템플릿 병합 기능을 제공합니다. 에이전트가 레이아웃을 한 번 설계하면, 프로덕션 코드는 JSON 데이터로 {{key}} 플레이스홀더를 채워 수많은 문서를 일관되게 생성합니다. 이는 매번 문서를 처음부터 생성할 때 발생하는 레이아웃 불일치와 토큰 소모를 줄여줍니다. watch 명령을 실행하면 로컬 브라우저에서 실시간 미리보기를 제공하며, 문서에 추가하거나 수정하는 모든 명령이 브라우저 화면에 즉시 반영됩니다. 엑셀의 경우 셀 편집과 차트 위치 조정을 실시간으로 지원해 사용자가 결과를 즉시 확인할 수 있습니다.
설치와 AI 에이전트 연동
OfficeCLI는 .NET 런타임이 내장된 단일 바이너리로 배포되어 추가 의존성 설치 없이 바로 사용할 수 있습니다. macOS, Linux, Windows 모두 지원하며, brew, scoop, npm 또는 설치 스크립트를 통해 설치할 수 있습니다. 설치 후 officecli install 명령을 실행하면 Claude Code, Cursor, GitHub Copilot 등 주요 AI 코딩 에이전트를 자동으로 감지하고 스킬 파일을 설치합니다. 이 과정이 완료되면 에이전트는 추가 설정 없이 즉시 Office 문서를 생성, 읽기, 수정할 수 있는 능력을 갖게 됩니다. MCP 서버도 내장되어 있어 JSON-RPC를 통해 문서 조작 도구를 노출할 수 있습니다.
사용 전 확인 사항
OfficeCLI는 Apache 2.0 라이선스로 배포되는 오픈소스 프로젝트입니다. 워드, 엑셀, 파워포인트 세 가지 형식 모두에 대해 읽기, 수정, 생성 기능을 지원하며, 특히 AI 에이전트와의 통합에 최적화되어 있습니다. 기존 오피스 파일과의 호환성을 위해 OOXML 표준을 따르지만, 일부 복잡한 기능은 원시 XML 접근(L3 레이어)을 통해 처리해야 할 수 있습니다. 다른 프로그램이 파일을 읽기 전에 OfficeCLI의 레지던트 모드가 디스크에 데이터를 완전히 저장했는지 확인하는 것이 좋습니다. save 또는 close 명령을 통해 명시적으로 플러시하거나, 환경 변수를 설정해 자동 플러시 주기를 조정할 수 있습니다.
