프로젝트 소개

OfficeCLI는 Word(.docx), Excel(.xlsx), PowerPoint(.pptx) 파일을 읽고, 편집하고, 생성하고, 자동화하기 위한 오픈소스 단일 바이너리 명령줄 도구입니다. Office 설치가 필요 없으며 자체 .NET 런타임을 포함하므로 macOS, Linux, Windows에서 실행할 수 있고 헤드리스 컨테이너 및 CI 환경에서도 작동합니다. 주요 초점은 AI 에이전트입니다. 단일 curl 명령으로 스킬 파일을 가져와 에이전트가 바이너리 설치 및 명령 사용법을 학습할 수 있습니다. 내장 HTML 렌더링 엔진은 문서를 HTML 또는 페이지별 PNG로 변환하여 멀티모달 에이전트가 렌더링된 출력을 검사하고 반복 작업을 수행할 수 있게 합니다. `watch` 명령은 localhost:26315에서 자동 새로고침되는 로컬 미리보기를 제공하며, Excel watch는 인라인 셀 편집 및 차트 위치 변경을 지원합니다. 핵심 기능은 세 가지 계층으로 구성됩니다: 고급 뷰(`view` 명령의 text, annotated, outline, stats, issues, html, svg, screenshot 모드), 구조화된 DOM 작업(`get`, `query`, `set`, `add`, `remove`, `move`, `swap`), 원시 XML 접근(`raw`, `raw-set`, `add-part`, `validate`). 문서는 `/slide[1]/shape[1]`과 같은 경로 선택자로 주소를 지정할 수 있으며 결과는 구조화된 JSON으로 반환됩니다. 형식별 기능으로는 Word의 i18n 및 RTL 지원, 문단, 실행, 표, 스타일, 텍스트 상자, 머리글/바닥글, 이미지, LaTeX 수식, mermaid 다이어그램, 주석, 각주, 워터마크, 책갈피, 목차, 차트, 하이퍼링크, 섹션, 양식 필드, 콘텐츠 컨트롤, 필드, OLE 개체 및 변경 내용 추적이 포함됩니다. Excel은 셀, 동적 배열을 포함한 350개 이상의 자동 계산 수식, 시트, 표, 정렬, 조건부 서식, 차트, 피벗 테이블, 슬라이서, 이름 정의 범위, 데이터 유효성 검사, 이미지, 스파크라인, 주석, 자동 필터, 도형 및 CSV/TSV 가져오기를 지원합니다. PowerPoint는 슬라이드, 도형, 이미지, 표, 차트, 애니메이션, 전환, 3D .glb 모델, 슬라이드 확대/축소, 수식, 다이어그램, 테마, 커넥터, 비디오/오디오, 그룹, 메모, 주석, SmartArt, OLE 개체 및 자리 표시자를 지원합니다. 추가 엔진으로는 네이티브 OOXML 피벗 테이블을 작성하는 수식 및 피벗 엔진, 문단, 셀, 도형, 머리글, 바닥글 및 차트 제목에서 JSON의 {{key}} 자리 표시자를 채우는 템플릿 병합 명령, 문서 또는 하위 트리를 재생 가능한 JSON으로 직렬화하는 덤프/배치 왕복 기능이 있습니다. 상주 모드는 문서를 메모리에 유지하여 지연 시간이 낮은 다단계 편집을 가능하게 하고, 배치 모드는 실패 시 롤백과 함께 여러 작업을 원자적으로 적용합니다. 통합 옵션에는 Claude Code, Cursor, VS Code/Copilot 및 LM Studio에 등록 가능한 내장 MCP 서버가 포함되며, curl 스크립트, Homebrew, Scoop, npm 또는 직접 릴리스 바이너리를 통해 설치할 수 있습니다. 동반 데스크톱 앱인 AionUi는 OfficeCLI 위에 자연어 문서 생성을 제공합니다. 이 프로젝트는 Apache 2.0 라이선스로 배포됩니다.