iOfficeAI/OfficeCLI

OfficeCLI – AI 친화적인 명령줄 오피스 스위트

무엇인가요 – Microsoft Office가 설치되어 있지 않아도 프로그램(특히 LLM 기반 에이전트)이 Microsoft Word, Excel, PowerPoint 파일을 생성, 읽기, 편집, 렌더링할 수 있는 단일 자가 포함 바이너리입니다. 모든 작업은 간단한 CLI 명령어(officecli create …, officecli add …, officecli view …)로 제공됩니다.

AI에게 왜 중요한가요 – 이 도구는 자체 고정밀 HTML/PNG 렌더링 엔진을 내장하고 있어, LLM이 문서가 실제로 어떻게 보이는지 정확히 확인하고, 레이아웃 문제를 탐지한 후 '렌더링 → 보기 → 수정'의 밀도 높은 루프로 바로 수정할 수 있습니다. 또한 모든 요소에 대해 구조화된 JSON 출력을 제공하므로, 에이전트가 문서의 내용을 논리적으로 이해하기 쉬워집니다.

주요 기능

• 생성 – 새 .docx, .xlsx, .pptx 파일을 처음부터 만들 수 있습니다.
• 읽기 – 텍스트, 스타일, 수식, 차트, 표, 이미지, 주석 등을 일반 텍스트 또는 상세한 JSON으로 읽을 수 있습니다.
• 수정 – add, set, remove 명령어를 통해 텍스트, 폰트, 색상, 레이아웃, 수식, 차트, 형태, 비디오, 3D 모델 등 모든 요소를 수정할 수 있습니다.
• 렌더링 – HTML, PNG 스크린샷, 또는 실시간 갱신되는 로컬 웹 미리보기(officecli watch)로 문서를 출력할 수 있습니다.
• 템플릿 병합 – 템플릿 내 {{key}} 자리 표시자를 JSON 데이터로 치환합니다.
• 배치 덤프/재생 – 전체 문서나 하위 트리를 JSON으로 직렬화하여 재현 가능한 편집 파이프라인을 구축할 수 있습니다.
• Excel 엔진 – Excel을 열지 않고도 350개 이상의 내장 함수, 동적 배열, 피벗 테이블, 슬라이서, 조건부 서식 등을 평가합니다.
• 완전한 포맷 지원 – Word, Excel, PowerPoint 모두 읽기-수정-생성이 가능합니다 (표의 ✓ 표시).

일반적인 워크플로우

# 설치 (ワン라인)
curl -fsSL https://officecli.ai/SKILL.md   # AI 에이전트용
# 또는 curl …/install.sh | bash               # 인간용

# 프레젠테이션 생성 및 슬라이드 추가
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"

# 해당 슬라이드에 텍스트 박스 추가
officecli add deck.pptx '/slide[1]' \
  --type shape --prop text="Revenue grew 25%" \
  --prop x=2cm --prop y=5cm --prop font=Arial --prop size=24

# 브라우저에서 즉시 미리보기
officecli watch deck.pptx   # http://localhost:26315는 각 명령어마다 자동 갱신

Word(officecli add report.docx …)와 Excel(officecli add budget.xlsx '/Sheet1' --type cell …)에서도 동일한 패턴이 적용됩니다.

설치 – .NET 런타임을 내장한 단일 바이너리로 배포됩니다. 다음 방법으로 설치 가능:

• 원라인 스크립트 (curl … | bash 또는 PowerShell 동등)
• Homebrew, Scoop, npm (brew install officecli, scoop install officecli, npm i -g @officecli/officecli)
• 해당 플랫폼용 바이너리 직접 다운로드

누가 이득을 볼 수 있나요

• AI 에이전트 (Claude Code, Cursor, GitHub Copilot 등)는 단일 명령어로 Office 파일을 생성하거나 편집하고, 시각적 피드백을 받을 수 있습니다.
• 개발자는 보고서 자동 생성, 일괄 스타일 업데이트, CI/CD 문서 파이프라인, 컨테이너 내 헤드리스 Office 자동화를 수행할 수 있습니다.
• 팀은 템플릿을 복제하고 데이터로 채우며, 문서를 자동으로 검증할 수 있습니다.

더 알아보기 – 공식 사이트: https://officecli.ai, Discord 커뮤니티, 각 형식에 대한 상세한 위키 페이지 (예: Word 단락, Excel 피벗, PowerPoint 애니메이션).