OfficeCLI – AI エージェント向けに構築されたオープンソース オフィススイート
OfficeCLI – AI エージェント向けに構築されたオープンソース オフィススイート
OfficeCLI は AI エージェントにヘッドレスで Office ドキュメントを単一コマンドでフルコントロールさせます
OfficeCLI は、AI エージェントが Microsoft Office を必要とせずに .docx、.xlsx、.pptx ファイルを作成・読み取り・変更できるように特化した初のオープンソーススイートです。自己完結型バイナリとして配布され、高忠実度の HTML/PNG レンダリングを提供し、エージェントが直接呼び出せる決定論的な JSON ベースの CLI を公開します。
ワンラインインストールと即時 AI 統合
- macOS/Linux では
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash（Windows は PowerShell）でインストールできます。このスクリプトは単一バイナリを配置し、Claude Code、Cursor、GitHub Copilot、VS Code などの AI ツールが自動的に検出する skill file を登録します。 - AI エージェント向けには
curl -fsSL https://officecli.ai/SKILL.mdでスキルファイルを取得します。バイナリがパスに入っていれば、エージェントは追加設定なしで任意のofficecliコマンドを実行できます。
"Very good and well done. I found immediate use‑case for this." – HN commenter @pdp
コア機能の概要
| 機能 | 内容 | AI にとっての重要性 |
|---|---|---|
| Create / read / modify | officecli add deck.pptx / --type slide --prop title="Q4 Report" のような単一コマンドで、数十行の Python/JavaScript コードを置き換えます。 |
トークン使用量を最小化し、ライブラリ依存の煩わしさを排除します。 |
| Built‑in rendering engine | officecli view deck.pptx html は忠実な HTML プレビューを生成し、officecli view deck.pptx screenshot はスライドごとの PNG を出力します。 |
エージェントが視覚結果を 見る ことで、ヘッドレス CI 環境での render → look → fix ループを閉じられます。 |
| Formula & pivot engine | 350 以上の Excel 関数が書き込み時に自動評価され、officecli add sales.xlsx '/Sheet1' --type pivottable … で完全に埋め込まれたピボットテーブルを作成します。 |
Excel への往復が不要になり、エージェントは計算結果を即座に取得できます。 |
| Template merge | officecli merge template.docx out.docx '{"client":"Acme"}' は全フォーマットで {{key}} プレースホルダーを置換します。 |
レイアウトは一度作成すれば、トークンコストゼロで N 回埋め込めます。 |
| Round‑trip dump / batch | officecli dump report.docx -o blueprint.json は任意の文書（またはサブツリー）を JSON にシリアライズし、officecli batch new.docx --input blueprint.json で再生します。 |
エージェントは既存ドキュメントから学習し、生の OOXML を解析せずにバリエーションを生成できます。 |
| Resident mode & live preview | officecli open report.docx はファイルをメモリ上に保持し、officecli watch report.pptx は自動更新ブラウザプレビューを提供します。 |
マルチステップワークフローでほぼゼロレイテンシ、即時の視覚フィードバックが得られます。 |
| MCP server | officecli mcp claude はすべての操作を JSON‑RPC で公開し、シェルアクセスなしで任意の LLM がツールとして利用可能にします。 |
プロプライエタリ IDE アシスタントとの統合がシンプルになります。 |
3 層アーキテクチャで LLM に安全な段階的複雑性を提供
- L1 – Read – 高レベルビュー (
view outline,view html,view issues)。 - L2 – DOM – 構造化要素操作 (
get,query,set,add,remove)。パスは安定 (/slide[1]/shape[2]) で、XPath に依存しません。 - L3 – Raw XML – フォールバックとして直接 XPath 操作 (
raw,raw-set) を提供。
"If you don’t need interactive/animated features, I can absolutely recommend to have the agent build slides in HTML and convert it to PDF. Has been a game changer for me." – HN commenter pietz
コミュニティがハイライトした実践的ユースケース
- 自動レポーティング – CI パイプラインでデータベースクエリから Word レポートや Excel ダッシュボードを生成。
- バッチ文書検証 –
officecli validate report.docx && officecli view report.docx issues --jsonにより、エージェントは配布前にレイアウト、引用、数式エラーを自己修正できます。 - エンタープライズ監査 – コメントで指摘されたように、二段階の検証層（リビジョン/属性付与）が企業導入に必須です。OfficeCLI の
view issuesと決定論的 JSON 出力はその基盤を提供します。 - クロス言語 SDK – 軽量 Python ラッパー (
pip install officecli-sdk) と Node.js ラッパー (npm install @officecli/sdk) により、プロセス起動なしで CLI を組み込めます。
既存アプローチとの比較
| 基準 | OfficeCLI | Microsoft Office (COM) | LibreOffice (UNO) | python‑docx / openpyxl |
|---|---|---|---|---|
| オープンソース & 無料 | ✅ (Apache 2.0) | ❌ (licensed) | ✅ | ✅ |
| ヘッドレス、Office 不要 | ✅ | ❌ | 部分的 | ✅ (Python 必要) |
| 単一バイナリ、クロスプラットフォーム | ✅ | ❌ | ❌ (複数パッケージ) | |
| パスベース要素アクセス | ✅ | ❌ | ❌ | ❌ |
| 高忠実度レンダリング内蔵 | ✅ | ❌ | ❌ | |
| JSON 互換ツール出力 | ✅ | ❌ | ❌ | |
テンプレートマージ ({{key}}) |
✅ | ❌ | ❌ | |
ライブプレビュー (watch) |
✅ | ❌ | ❌ |
ディスカッションからの FAQ
- OfficeCLI はマクロや VBA をサポートしていますか？ – 現在の機能は OOXML 操作に焦点を当てており、マクロは実行されません。Excel の数式は内蔵エンジンで評価されますが、VBA コードは実行されません。
- 実装は ECMA‑376 に準拠していますか？ – コメントの一つで ECMA‑376 のテストカバレッジが不足している点が指摘されています。OfficeCLI は機能的互換性を目指しますが、正式なコンプライアンステストはまだ主要目標ではありません。
- LibreOffice ファイルと連携できますか？ –
.odt/.ods/.odpへのネイティブサポートはありません。ツールは Microsoft Office Open XML 形式のみに限定されています。 - HTML → PDF パイプラインと比べてどうですか？ – 静的コンテンツでは HTML‑to‑PDF の方がシンプルな場合がありますが、OfficeCLI はチャート、アニメーション、ピボットテーブルなど、HTML では表現できないネイティブ Office 機能を保持します。
開発者向けクイックスタート
# Install (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Create a presentation and add a slide
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"
# Live preview in the browser
officecli watch deck.pptx # opens http://localhost:26315
# Export a high‑fidelity PNG of slide 1
officecli view deck.pptx screenshot --page 1 -o slide1.png
# Dump the document structure to JSON for an agent to learn from
officecli dump deck.pptx -o blueprint.json
次のステップ
- Documentation – Wiki には Word、Excel、PowerPoint 各フォーマットのリファレンスとエンドツーエンドのワークフロー例が掲載されています。
- Community – リポジトリからリンクされている Discord に参加して、エージェント統合パターンを議論しましょう。
- Contributing – PR を歓迎します。ソースからビルドするには .NET 10 SDK が必要ですが、リリースバイナリは完全に自己完結しています。
OfficeCLI は、目的特化型のヘッドレス Office スイートが LLM を用いた文書自動化の摩擦を大幅に削減し、CI パイプラインや自律エージェント内で Office 資産を生成・検証・反復できることを実証しています。