OfficeCLI

OfficeCLI는 AI 에이전트를 위해 설계된 세계 최초이자 최고의 Office 스위트입니다.

단 한 줄의 코드로 어떤 AI 에이전트에게든 Word, Excel, PowerPoint에 대한 완전한 제어권을 부여하세요.

오픈 소스 (Open-source). 단일 바이너리 (Single binary). Office 설치 불필요. 의존성 없음. 어디서나 작동.

OfficeCLI의 내장 HTML 렌더링 엔진은 문서를 높은 충실도로 재현하며 — 이것이 AI에게 시각을 제공합니다. .docx / .xlsx / .pptx를 HTML 또는 PNG로 렌더링하여, 렌더링(render) → 확인(look) → 수정(fix) 루프를 완성합니다.

English | 中文 | 日本語 | 한국어

<p align="center"> <strong>🌐 웹사이트 (Website):</strong> <a href="https://officecli.ai" target="_blank">officecli.ai</a> &nbsp;|&nbsp; <strong>💬 커뮤니티 (Community):</strong> <a href="https://discord.gg/2QAwJn7Egx" target="_blank">Discord</a> </p> <p align="center"> <img src="assets/ppt-process.webp" alt="OfficeCLI creating a PowerPoint presentation on AionUi" width="100%"> </p> <p align="center"><em><a href="https://github.com/iOfficeAI/AionUi">AionUi</a>에서 OfficeCLI를 사용한 PPT 생성 과정</em></p> <p align="center"><strong>PowerPoint 프레젠테이션 (PowerPoint Presentations)</strong></p> <table> <tr> <td width="33%"><img src="assets/designwhatmovesyou.gif" alt="OfficeCLI design presentation (PowerPoint)"></td> <td width="33%"><img src="assets/horizon.gif" alt="OfficeCLI business presentation (PowerPoint)"></td> <td width="33%"><img src="assets/efforless.gif" alt="OfficeCLI tech presentation (PowerPoint)"></td> </tr> <tr> <td width="33%"><img src="assets/blackhole.gif" alt="OfficeCLI space presentation (PowerPoint)"></td> <td width="33%"><img src="assets/first-ppt-aionui.gif" alt="OfficeCLI gaming presentation (PowerPoint)"></td> <td width="33%"><img src="assets/shiba.gif" alt="OfficeCLI creative presentation (PowerPoint)"></td> </tr> </table> <p align="center">—</p> <p align="center"><strong>Word 문서 (Word Documents)</strong></p> <table <tr <td width="33%"><img src="assets/showcase/word1.gif" alt="OfficeCLI 학술 논문 (Word)"></td> <td width="33%"><img src="assets/showcase/word2.gif" alt="OfficeCLI 프로젝트 제안서 (Word)"></td> <td width="33%"><img src="assets/showcase/word3.gif" alt="OfficeCLI 연례 보고서 (Word)"></td> </tr> </table> <p align="center">—</p> <p align="center"><strong >Excel 스프레드시트</strong></strong ></p> <table <tr <td width="33%"><img src="assets/showcase/excel1.gif" alt="OfficeCLI 예산 추적기 (Excel)"></td> <td width="33%"><img src="assets/showcase/excel2.gif" alt="OfficeCLI 성적표 (Excel)"></td> <td width="33%"><img src="assets/showcase/excel3.gif" alt="OfficeCLI 판매 대시보드 (Excel)"></td> </tr> </table> <p align="center"><em >위에 있는 모든 문서는 OfficeCLI를 사용하여 AI 에이전트에 의해 완전히 생성되었습니다 — 템플릿 사용이나 수동 편집이 필요하지 않습니다.</em ></p>

AI 에이전트를 위한 시작 방법 (Get Started in One Line)

AI 에이전트의 채팅창에 다음 내용을 붙여넣기만 하세요. 스킬 파일을 읽고 모든 것을 자동으로 설치할 것입니다:

curl -fsSL https://officecli.ai/SKILL.md

그게 전부입니다. 이 스킬 파일은 에이전트에게 바이너리를 설치하고 모든 명령어를 사용하는 방법을 가르쳐 줍니다.

일반 사용자 (For Humans)

옵션 A — GUI: AionUi를 설치하세요. 이 데스크톱 앱은 OfficeCLI를 기반으로 작동하며, 자연어를 통해 Office 문서를 생성하고 편집할 수 있게 해줍니다. 원하는 것만 설명하면 AionUi가 나머지를 처리합니다.

옵션 B — CLI: GitHub Releases에서 사용하려는 플랫폼의 바이너리를 다운로드한 다음, 다음을 실행하세요:

officecli install

이 명령어는 바이너리를 PATH에 복사하고 감지된 모든 AI 코딩 에이전트(Claude Code, Cursor, Windsurf, GitHub Copilot 등)에 officecli 스킬을 설치합니다. 추가적인 설정 없이도 사용자의 에이전트는 즉시 Office 문서를 생성, 읽기 및 편집할 수 있습니다.

개발자 (For Developers) — 30초 만에 라이브로 확인하기

# 1. 설치 (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
...

끝입니다. 실행하는 모든 add, set, 또는 remove 명령은 실시간으로 미리보기를 새로고침합니다. 계속해서 실험해 보세요. 브라우저가 여러분의 실시간 피드백 루프 (feedback loop) 역할을 할 것입니다.

빠른 시작 (Quick Start)

# 프레젠테이션을 생성하고 콘텐츠 추가하기
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
...

{
  "tag": "shape",
  "path": "/slide[1]/shape[1]",
...

왜 OfficeCLI인가?

기존에 50줄의 Python 코드와 3개의 별도 라이브러리가 필요했던 작업이:

from pptx import Presentation
from pptx.util import Inches, Pt
prs = Presentation()
...

이제는 단 하나의 명령어로 가능합니다:

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

OfficeCLI가 할 수 있는 일:

• 생성 (Create): 빈 문서 또는 콘텐츠가 포함된 문서를 처음부터 생성
• 읽기 (Read): 텍스트, 구조, 스타일, 수식을 일반 텍스트 또는 구조화된 JSON 형식으로 읽기
• 분석 (Analyze): 서식 문제, 스타일 불일치 및 구조적 문제 분석
• 수정 (Modify): 텍스트, 글꼴, 색상, 레이아웃, 수식, 차트, 이미지 등 모든 요소 수정
• 재구성 (Reorganize): 문서 간 요소 추가, 삭제, 이동 및 복사를 통한 콘텐츠 재구성

형식	읽기	수정	생성
Word (.docx)	✅	✅	✅
...
Word — 완전한 i18n & RTL 지원 (스크립트별 글꼴 슬롯, 스크립트별 BCP-47 언어 태그 lang.latin/ea/cs, 복합 스크립트 굵게/기울임/크기, 단락/런(run)/섹션/표/스타일/머리글/바닥글/docDefaults를 통한 direction=rtl 캐스케이딩, rtlGutter + pgBorders 약어, 힌디어/아랍어/태국어/CJK를 위한 로캘 인식 페이지 번호 매기기; create --locale ar-SA 시 RTL 자동 활성화), 단락 (paragraphs) (framePr, 탭 약어, 문자 기반 들여쓰기), 런 (runs) (underline.color, 위치 half-pts), 표 (tables) (가상 열 작업 add/remove/move/copyfrom, hMerge), 스타일 (styles), 텍스트 상자 / 도형 (textbox / shape) (회전, 세로 쓰기 eaVert/vert270, 그라데이션, 그림자, 불투명도), 머리글/바닥글 (headers/footers), 이미지 (images) (PNG/JPG/GIF/SVG), 수식 (equations) (LaTeX 입력), 다이어그램 (diagrams) (mermaid → 네이티브 편집 가능한 도형, 또는 모든 mermaid 타입을 고충실도 PNG로 변환), 메모 (comments), 각주 (footnotes), 워터마크 (watermarks), 책갈피 (bookmarks), 목차 (TOC), 차트 (charts), 하이퍼링크 (hyperlinks),

섹션(sections)—form fields, 콘텐츠 컨트롤 (SDT), 필드 (22개의 제로 파라미터 타입 + MERGEFIELD / REF / PAGEREF / SEQ / STYLEREF / DOCPROPERTY / IF), OLE 개체, 개정 사항 / 추적 변경 (revision.type=ins|del|format|moveFrom|moveTo + revision.action=accept|reject, 대상별 /revision[@author=Alice] 선택자, 추적 찾기 및 바꾸기), 페이지 배경색, 문서 속성

Excel — 셀 (추가 시 발음 가이드 / 후리가나, 제거 시 Excel-UI --shift left|up / 추가 시 shift=right|down), 수식(350개 이상의 내장 함수와 자동 평가, _xlfn. 자동 접두사를 사용한 스필링 동적 배열, 재무/채권 및 통계 계열, OFFSET/INDIRECT, 파싱 시 인라인으로 정의된 이름의 수식 본문, 행/열 삽입 시 수식 참조 재작성), 시트 (보이는/숨겨진/매우 숨겨진, 인쇄 여백, printTitleRows/Cols, RTL sheetView, 캐스케이드 인식 시트 이름 변경, 열기 시 빈 셀 블로트 필터), 부울 and/or 선택자 (row[Salary>5000 and Region=EMEA]), 테이블, 정렬 (시트 / 범위, 다중 키, 사이드카어 인식), 조건부 서식, 차트 (박스 플롯 포함, 자동 정렬 + 누적 %, 로그 축), [피벗

tables](https://github.com/iOfficeAI/OfficeCLI/wiki/excel-pivottable) (다중 필드 (multi-field), 날짜 그룹화 (date grouping), 데이터 표시 방식 (showDataAs), 정렬 (sort), 총계 (grandTotals), 부분합 (subtotals), 압축/윤곽/표 형식 레이아웃 (compact/outline/tabular layout), 항목 레이블 반복 (repeat item labels), 빈 행 (blank rows), 계산된 필드 (calculated fields), 지속적인 labelFilter / topN / fillDownLabels, CoW 캐시 + 피벗 간 공유 (cache CoW + cross-pivot sharing)), 슬라이서 (slicers), 이름 정의된 범위 (named ranges), 데이터 유효성 검사 (data validation), 이미지 (images) (이중 표현 방식 폴백을 지원하는 PNG/JPG/GIF/SVG), 스파크라인 (sparklines), 메모 (comments) (RTL), 자동 필터 (autofilter), 도형 (shapes), OLE 개체 (OLE objects), CSV/TSV 가져오기, $Sheet:A1 셀 주소 지정