OfficeCLI: 단일 바이너리로 AI 에이전트가 Word/Excel/PowerPoint를 읽고 편집하고 렌더링

graphify: 어떤 코드베이스든 쿼리 가능한 지식 그래프로 바꿔 Claude Code에 제공 • DeepTutor: 홍콩대가 만든, 메모리를 검토할 수 있는 에이전트 네이티브 튜터링 워크스페이스

OfficeCLI란 무엇인가? #

OfficeCLI는 구체적이지만 화려하지 않은 빈틈 하나를 겨냥한다: AI 에이전트는 코드와 텍스트를 잘 쓰지만, 실제 .docx, .xlsx, .pptx 파일을 진짜로 편집하는 일 — 서식, 수식, 레이아웃을 유지하면서 — 은 보통 실제 Microsoft Office를 COM으로 자동화하거나 원시 OOXML까지 내려가야 했다. OfficeCLI는 에이전트가 하나의 일관된 CLI와 JSON 인터페이스로 세 가지 형식을 모두 생성·읽기·분석·수정할 수 있도록 설계된, 오픈소스(Apache-2.0) 단일 바이너리다.

🔗 GitHub: https://github.com/iOfficeAI/OfficeCLI 🌐 홈페이지: https://officecli.ai

2026년 3월 첫 공개 이후 2026년 7월 말 기준 2만 2885개 GitHub 스타를 기록했다. Office 설치도, 의존성도 필요 없으며, 프로젝트에 따르면 .NET 런타임이 내장된 독립형 바이너리로 배포된다.

프로젝트가 처음 제시하는 예시: 예전에는 python-pptx로 슬라이드 하나 만드는 데 50줄짜리 보일러플레이트가 필요했지만, 지금은 명령 하나면 된다:

officecli add deck.pptx / --type slide --prop title="Q4 Report"

렌더링-확인-수정 루프 #

OfficeCLI를 일반적인 문서 조작 라이브러리와 가장 크게 구분 짓는 기능: 내장 HTML/PNG 렌더링 엔진 덕분에 에이전트가 문서를 렌더링하고, 실제로 렌더링된 결과를 살펴본 뒤, 문제를 스스로 고칠 수 있다 — 사람이 파일을 직접 열어 확인하지 않고서는 불가능했던 루프를 닫는다.

officecli watch deck.pptx    # http://localhost:26315에서 실시간 미리보기, 편집 시 자동 새로고침

다른 터미널에서 실행하는 모든 add, set, remove 명령이 미리보기를 실시간으로 갱신한다 — 에이전트가 문서를 단계별로 만들어가는 과정을 지켜보기에 좋다.

설치 #

원라인(macOS/Linux):

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

Windows(PowerShell):

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

또는 패키지 매니저로:

brew install officecli
npm install -g @officecli/officecli

그다음:

officecli install

바이너리를 PATH에 등록하고, 감지된 모든 AI 코딩 에이전트 — Claude Code, Cursor, Windsurf, GitHub Copilot 등 — 에 OfficeCLI 스킬을 별도 설정 없이 설치한다.

AI 에이전트가 스스로 설정하게 하려면, 프로젝트가 제안하는 원라인 방식은 에이전트가 직접 curl -fsSL https://officecli.ai/SKILL.md를 가져와 읽게 하는 것이다 — 설치 단계와 명령 집합을 곧바로 가르쳐 준다.

빠른 시작 #

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"

officecli view deck.pptx --outline
# → Slide 1: Q4 Report
# →   Shape 1 [TextBox]: Revenue grew 25%

officecli view deck.pptx --html     # 브라우저에서 렌더링된 미리보기, 별도 서버 불필요
officecli get deck.pptx /slide[1]/shape[1] --json    # 어떤 요소든 구조화된 JSON으로 확인

무엇을 할 수 있나 #

가장 눈에 띄는 건 깊이다: 프로젝트 문서에 따르면 Word 지원은 단락/문자/섹션/표/스타일/머리글꼬리글 전체에 걸친 RTL/다국어 캐스케이딩, 작성자별 선택자를 가진 수정 이력 승인/거부, LaTeX 입력 수식까지 내려가고; Excel 지원은 내장 함수 350개 이상, 피벗 테이블, 조건부 서식, 슬라이서까지; PowerPoint 지원은 애니메이션 프리셋, 모프 전환, 3D 모델(.glb) 삽입, SmartArt 왕복 변환까지 포함한다. 전체 레퍼런스는 프로젝트 위키에 있으며 README에 링크돼 있다.

구조화된 명령이 다루지 못하는 경우를 위해 문서화된 L3 원시 XML 폴백도 있다 — L1은 상위 수준 뷰, L2는 요소 수준 작업, L3는 필요할 때 원시 OOXML까지 내려간다.

비교(프로젝트 자체 설명 기준) #

배치 모드와 안정성 #

officecli batch deck.pptx --commands "add / --type slide" "set /slide[1] --prop title=X"

배치 작업은 기본적으로 원자적이다 — 배치 안의 명령 하나라도 실패하면 파일이 절반만 수정된 채로 남지 않고 전체 배치가 롤백된다. --best-effort는 성공한 부분을 그대로 유지하고, --stop-on-error는 첫 실패에서 멈춘다(--best-effort와 함께 쓰지 않으면 역시 전체 롤백).

에이전트의 명령이 존재하지 않는 대상을 가리킬 때 OfficeCLI는 빈 스택 트레이스가 아니라 구조화되고 실행 가능한 오류를 반환한다:

# 에이전트가 잘못된 경로를 시도 → {"success": false, "error": {"code": "not_found", "suggestion": "..."}}
# 에이전트가 suggestion에 나온 사용 가능한 요소 목록을 보고 스스로 수정

사용 사례 #

1. 데이터베이스나 API에서 보고서 생성 #

템플릿을 채우고, 렌더링해 서식을 확인하고, 문제를 고치고, 최종 파일을 전달하는 과정을 파이프라인의 일부로 자동화한다.

2. CI/CD의 헤드리스 Office 자동화 #

그래픽 인터페이스가 있는 Office 라이선스를 설치·유지보수할 필요 없이 Docker/컨테이너 환경에서 문서 생성이나 검증을 실행한다.

3. 프롬프트에서 바로 발표 자료 만들기 #

코딩 에이전트와 조합해 자연어 브리핑에서 완전한 프레젠테이션을 생성하고, 실시간 미리보기 루프로 전달 전에 서식 문제를 잡아낸다.

4. 대량 문서 처리 #

한 번의 원자적 작업 안에서 여러 문서에 걸쳐 일괄 찾기/바꾸기, 스타일 업데이트, 형식을 넘나드는 템플릿 병합({{key}} 치환)을 수행한다.

관련 저장소 #

관련 글 #

• graphify: 어떤 코드베이스든 쿼리 가능한 지식 그래프로 바꿔 Claude Code에 제공 — AI 에이전트가 소비하도록 설계된 또 다른 로컬·결정적 도구
• DeepTutor: 홍콩대가 만든, 메모리를 검토할 수 있는 에이전트 네이티브 튜터링 워크스페이스 — 분야는 다르지만 “에이전트가 직접 조작하도록 설계"됐다는 철학은 같다

결론 #

OfficeCLI는 AI 코딩 에이전트가 겪는 실제 빈틈을 메운다 — 원시 텍스트만 생성하는 게 아니라 진짜 충실도로 Office 문서를 조작하며, 에이전트가 스스로 자신의 결과물을 검증할 수 있는 렌더링 엔진까지 갖췄다. 단일 바이너리, Office 라이선스 불필요, 구조화된 JSON 출력 전반이 python-docx로 스크립트를 짜거나 실제 Office 설치를 자동화하는 것보다 에이전트 워크플로에 훨씬 잘 맞는다.

추천 대상: 실제 Word/Excel/PowerPoint 파일을 프로그래밍 방식으로 생성·편집·일괄 처리해야 하는 개발자와 AI 에이전트, 특히 Office를 설치할 수 없는 헤드리스/CI 환경에서.

GitHub: https://github.com/iOfficeAI/OfficeCLI

셀프 호스팅 추천 인프라 #

OfficeCLI는 단일 바이너리로 헤드리스 CI 러너를 포함해 어디서든 실행된다:

• DigitalOcean — 14개 이상의 글로벌 리전, 60일간 200달러 무료 크레딧, 헤드리스 문서 생성 파이프라인에 무난하다.
• HTStack — 중국 본토에서 지연 시간이 짧은 홍콩 VPS. dibi8.com이 호스팅되는 것과 같은 IDC다.

제휴 링크입니다 — 추가 비용 없이 dibi8.com 운영을 돕습니다.

최종 업데이트: 2026-07-29

참고 자료 #

• OfficeCLI
• OfficeCLI 홈페이지
• AionUi