OfficeCLI: AIエージェントがMicrosoft Officeファイルを読み書きするためのOfficeスイート
OfficeCLI: Office suite for AI agents to read and edit Microsoft Office files (github.com)
要約
OfficeCLIは、AIエージェント向けに設計された世界初のOfficeスイートです。1行のコードでWord、Excel、PowerPointをAIエージェントに完全に制御させることができます。このオープンソースツールは、Officeのインストールや依存関係なしに、どこでも動作します。内蔵のHTMLレンダリングエンジンは、ドキュメントを高忠実度で再現し、AIに「目」を与えます。これにより、レンダリング→表示→修正のループを閉じることができます。AIエージェントは、自然言語でドキュメントの作成、読み取り、編集を指示でき、人間もGUIまたはCLIから利用可能です。
全文翻訳
OfficeCLI: AIエージェントがMicrosoft Officeファイルを読み書き・編集するためのOfficeスイート
URL: https://github.com/iOfficeAI/OfficeCLI
本文:
OfficeCLIは、AIエージェントのために設計された世界初かつ最高のOfficeスイートです。
あらゆるAIエージェントに、Word、Excel、PowerPointをコード一行で完全に制御させましょう。
オープンソース。シングルバイナリ。Officeのインストール不要。依存関係なし。どこでも動作します。
OfficeCLIの組み込みHTMLレンダリングエンジンは、ドキュメントを高忠実度で再現します — これがAIに「目」を与えるものです。 .docx / .xlsx / .pptx をHTMLまたはPNGにレンダリングし、「レンダリング → 確認 → 修正」のループを閉じます。
[画像: GitHub Release] [画像: License]
🌐 Website: officecli.ai | 💬 Community: Discord
[画像: OfficeCLIがAionUi上でPowerPointプレゼンテーションを作成]
OfficeCLIをAionUi上で使用したPPT作成プロセス
PowerPointプレゼンテーション
—
Wordドキュメント
—
Excelスプレッドシート
上記のすべてのドキュメントは、AIエージェントがOfficeCLIを使用して完全に作成されたものであり、テンプレートや手動編集は一切使用されていません。
AIエージェント向け — 一行で開始
AIエージェントのチャットにこれを貼り付けると、スキルファイルが読み込まれ、すべて自動的にインストールされます。
curl -fsSL https://officecli.ai/SKILL.md
これだけです。スキルファイルは、バイナリのインストール方法とすべてのコマンドの使用方法をエージェントに教えます。
人間向け
オプションA — GUI: AionUiをインストールします。これは、OfficeCLIを内部で利用して、自然言語でOfficeドキュメントを作成・編集できるデスクトップアプリです。必要なものを記述するだけで、AionUiが残りを処理します。
オプションB — CLI: GitHub Releasesからお使いのプラットフォーム用のバイナリをダウンロードし、以下を実行します。
officecli install
これにより、バイナリがPATHにコピーされ、検出されたすべてのAIコーディングエージェント(Claude Code、Cursor、Windsurf、GitHub Copilotなど)にofficecliスキルがインストールされます。エージェントは、追加の設定なしで、すぐにあなたの代わりにOfficeドキュメントを作成、読み取り、編集できるようになります。
開発者向け — 30秒でライブデモ
# 1. インストール (macOS / Linux) — または: brew install officecli / npm install -g @officecli/officecli
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
# 2. 空のPowerPointを作成
officecli create deck.pptx
# 3. ライブプレビューを開始 — ブラウザで http://localhost:26315 が開きます
officecli watch deck.pptx
# 4. 別のターミナルを開き、スライドを追加 — ブラウザが即座に更新されるのを確認します
officecli add deck.pptx / --type slide --prop title="Hello, World!"
これで完了です。実行するすべての add、set、または remove コマンドで、プレビューがリアルタイムに更新されます。ブラウザはライブフィードバックループなので、実験を続けてください。
クイックスタート
# プレゼンテーションを作成し、コンテンツを追加
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
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 --prop color=FFFFFF
# アウトラインとして表示
officecli view deck.pptx outline
# → Slide 1: Q4 Report
# → Shape 1 [TextBox]: Revenue grew 25%
# HTMLとして表示 — サーバー不要で、レンダリングされたプレビューをブラウザで開きます
officecli view deck.pptx html
# 任意の要素の構造化JSONを取得
officecli get deck.pptx '/slide[1]/shape[1]' --json
# 保存して閉じる — 常駐セッションをディスクにフラッシュします
officecli close deck.pptx
{
"tag": "shape",
"path": "/slide[1]/shape[1]",
"attributes": {
"name": "TextBox 1",
"text": "Revenue grew 25%",
"x": "720000",
"y": "1800000"
}
}
なぜOfficeCLIなのか?
かつて50行のPythonと3つの別々のライブラリを必要とした作業が:
from pptx import Presentation
from pptx.util import Inches, Pt
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[0])
title = slide.shapes.title
title.text = "Q4 Report"
# ... 45行追加 ...
prs.save('deck.pptx')
今や一行のコマンドで完了します。
officecli add deck.pptx / --type slide --prop title="Q4 Report"
OfficeCLIができること:
- 作成: ドキュメントをゼロから作成 — 空白またはコンテンツ付き
- 読み取り: テキスト、構造、スタイル、数式 — プレーンテキストまたは構造化JSONで
- 分析: 書式設定の問題、スタイルの不一致、構造的な問題
- 変更: 任意の要素 — テキスト、フォント、色、レイアウト、数式、チャート、画像
- 再編成: コンテンツ — ドキュメント間で要素を追加、削除、移動、コピー
| フォーマット | 読み取り | 変更 | 作成 |
|---|---|---|---|
| Word (.docx) | ✅ | ✅ | ✅ |
| Excel (.xlsx) | ✅ | ✅ | ✅ |
| PowerPoint (.pptx) | ✅ | ✅ | ✅ |
Word — 完全な国際化と右から左への対応(スクリプトごとのフォントスロット、スクリプトごとのBCP-47言語タグ lang.latin/ea/cs、複雑スクリプトの太字/斜体/サイズ、段落/実行/セクション/テーブル/スタイル/ヘッダー/フッター/ドキュメントデフォルトを介した direction=rtl のカスケード、rtlGutter + pgBorders ショートハンド、ヒンディー語/アラビア語/タイ語/CJK向けのロケール対応ページ番号付け;create --locale ar-SA でRTLを自動有効化)、段落(framePr、タブショートハンド、文字ベースのインデント)、実行(underline.color、位置半ポイント)、テーブル(仮想列操作の追加/削除/移動/コピー、hMerge)、スタイル、テキストボックス / 図形(テキストボックス: 回転、textDirection eaVert/vert270、グラデーション、影、不透明度)、ヘッダー/フッター、画像(PNG/JPG/GIF/SVG)、数式(LaTeX入力)、図(mermaid → ネイティブ編集可能図形、または任意のmermaidタイプをフル忠実度PNGとして)、コメント、脚注、透かし、しおり、目次、チャート、ハイパーリンク、セクション、フォームフィールド、コンテンツコントロール (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、解析時にインライン化される定義済み名前の数式本体、行/列挿入時の数式参照書き換え)、シート(表示/非表示/非表示、印刷マージン、印刷タイトル行/列、RTL sheetView、カスケード対応シート名変更、開く際の空セルブロートフィルタ)、ブール値 and/or セレクター(row[Salary>5000 and Region=EMEA])、テーブル、並べ替え(シート/範囲、複数キー、サイドカー対応)、条件付き書式、チャート(箱ひげ図、自動並べ替えと累積パーセンテージ付きパレート図、対数軸を含む)、ピボットテーブル(複数フィールド、日付グループ化、showDataAs、並べ替え、小計、概要、コンパクト/アウトライン/テーブルレイアウト、項目ラベルの繰り返し、空白行、計算フィールド、永続的な labelFilter / topN フィルター、キャッシュCoW + クロスピボット共有)、スライサー、名前付き範囲、データ検証、画像(フォールバックとしてのデュアル表現付きPNG/JPG/GIF/SVG)、スパークライン、コメント(RTL)、オートフィルター、図形、OLEオブジェクト、CSV/TSVインポート、$Sheet:A1 セルアドレス指定
PowerPoint — スライド(ヘッダー/フッター/日付/スライド番号の切り替え、非表示)、図形(パターン塗りつぶし、ぼかし効果、ハイパーリンクツールチップとスライドジャンプリンク、実行のハイライト色、slideMaster/slideLayout 型追加/設定/削除、矢印エイリアス、effective.X + effective.X.src)、画像(PNG/JPG/GIF/SVG、塗りつぶしモード: ストレッチ/コンテナ/カバー/タイル、明るさ/コントラスト/グロー/影、回転、リンク+ツールチップ)、テーブル(組み込みPowerPointスタイルカタログ、仮想 /col[C] 取得 + スワップ/コピー、行/列移動/コピー、塗りつぶし/背景エイリアス)、チャート(複合円グラフ、複合棒グラフ、属性ごとの軸線/グリッド線設定、テーマパレットによる系列追加/削除、anchor=x,y,w,h ショートハンド)、アニメーション(15個の強調 + 16個の終了テンプレートベースプリセット、複数エフェクトチェーン、モーションパスプリセット、繰り返し/再開/自動反転、チャートアニメーション + chartBuild)、画面切り替え(モーフィング + p14 + 12個のp15 PowerPoint 2013+プリセット)、3Dモデル (.glb)(結合された rotation=ax,ay,az)、スライドズーム、数式(LaTeX入力)、図(mermaidフローチャート/シーケンス → ネイティブ編集可能図形、または任意のmermaidタイプをフル忠実度PNGとして)、テーマ、コネクタ(from/to は完全な /slide[N]/shape[@name=Foo] パスを受け入れる)、ビデオ/オーディオ(ループ、自動開始)、グループ(リンク+ツールチップ; Get/Query/Add/Removeはすべてグループ内に下降)、ノート(RTL、言語)、コメント(RTL、レガシー+モダンp188スレッドラウンドトリップ)、SmartArt(add-part + raw-setによるラウンドトリップ)、OLEオブジェクト、プレースホルダー(phTypeによる追加/設定)
ユースケース
開発者向け:
- データベースやAPIからのレポート生成の自動化
- ドキュメントのバッチ処理(一括検索/置換、スタイル更新)
- CI/CD環境でのドキュメントパイプラインの構築(テスト結果からのドキュメント生成)
- Docker/コンテナ化された環境でのヘッドレスOffice自動化
AIエージェント向け:
- ユーザープロンプトからのプレゼンテーション生成(上記の例を参照)
- ドキュメントから構造化データをJSONに抽出
- 配信前のドキュメント品質の検証とチェック
チーム向け:
- ドキュメントテンプレートのクローンを作成し、データで埋める
- CI/CDパイプラインでの自動ドキュメント検証
インストール
単一の自己完結型バイナリとして出荷されます。.NETランタイムが埋め込まれているため、インストール不要で、ランタイムの管理も不要です。
一行インストール:
# 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
またはパッケージマネージャー経由で:
# Homebrew (macOS / Linux)
brew install officecli
# Scoop (Windows)
scoop install officecli
# npm (全プラットフォーム — お使いのプラットフォームのネイティブバイナリを取得します)
npm install -g @officecli/officecli
またはGitHub Releasesから手動でダウンロード:
| プラットフォーム | バイナリ |
|---|---|
| macOS Apple Silicon | officecli-mac-arm64 |
| macOS Intel | officecli-mac-x64 |
| Linux x64 | officecli-linux-x64 |
| Linux ARM64 | officecli-linux-arm64 |
| Windows x64 | officecli-win-x64.exe |
| Windows ARM64 | officecli-win-arm64.exe |
インストールを確認: officecli --version
またはダウンロードしたバイナリから自己インストール(または officecli をそのまま実行して自動インストール):
officecli install # 明示的
officecli # 引数なしの呼び出しでもインストールがトリガーされます
アップデートはバックグラウンドで自動的にチェックされます。無効にするには officecli config autoUpdate false を実行するか、呼び出しごとに OFFICECLI_SKIP_UPDATE=1 を指定してスキップします。設定は ~/.officecli/config.json に保存されます。
主要機能
組み込みエンジンと生成プリミティブ
OfficeCLIは自己完結型です。以下の機能はバイナリ内に含まれており、Officeは不要です。
レンダリングエンジン — 高忠実度、組み込み
OfficeCLIの要石: スクラッチから開発された高忠実度のHTMLレンダリングエンジンにより、AIエージェントはDOMから推測するのではなく、レンダリングされたドキュメントを「見る」ことができます。図形、チャート(トレンドライン、エラーバー、ウォーターフォール、ローソク足、スパークライン)、数式(OMML → LaTeX、KaTeXでレンダリング)、Three.js経由の3D .glb モデル、モーフィングトランジション、スライドズーム、図形効果をカバーしています。ページごとのPNGスクリーンショットは、レンダリングされたHTMLをヘッドレスブラウザ経由でパイプすることで生成されます。3つのモードがあります。
view html— スタンドアロンHTMLファイル、アセットはインライン化されます。任意のブラウザで開けます。view screenshot— ページごとのPNG、マルチモーダルエージェントが読み取る準備ができています。watch— 自動リフレッシュプレビュー付きのローカルHTTPサーバー。add/set/removeのたびにブラウザが即座に更新されます。Excelのwatchモードは、インラインセル編集とチャートのドラッグアンドドロップによる再配置をサポートします。
officecli view deck.pptx html -o /tmp/deck.html
officecli view deck.pptx screenshot -o /tmp/deck.png # 複数スライドの場合は --page 1-N を追加
officecli watch deck.pptx # http://localhost:26315
可視化なしでは、スライドを生成するエージェントは盲目的に作業していることになります — DOMは読めますが、タイトルがオーバーフローしているか、2つの図形が重なっているかはわかりません。レンダリングはバイナリに組み込まれているため、「レンダリング → 確認 → 修正」ループは、CI、Docker、ディスプレイのないサーバー — バイナリが実行される場所ならどこでも機能します。
数式 & ピボットエンジン
350以上の組み込みExcel関数が書き込み時に自動評価されます — =SUM(A1:A2) と入力し、セルを get すると、値はすでにそこにあります。再計算のためにOfficeへのラウンドトリップは不要です。スピルダイナミック配列(FILTER / SORT / UNIQUE / SEQUENCE / LET / LAMBDA / MAP)、VLOOKUP / XLOOKUP / INDEX / MATCH、財務・債券数学(XIRR / PRICE / YIELD / DURATION / COUPNUM)、統計分布、テストと回帰(NORM.DIST / T.TEST / LINEST)、日付とテキスト関数をカバーしています。
さらに、ネイティブOOXMLピボットテーブルを単一コマンドでソース範囲から作成できます — マルチフィールドの行/列/フィルター、10種類の集計、showDataAs モード、日付グループ化、計算フィールド、トップN、レイアウト。ピボットキャッシュと定義はOOXMLに書き込まれるため、Excelを開くと集計がすでに表示されています。
officecli add sales.xlsx '/Sheet1' --type pivottable \
--prop source='Data!A1:E10000' --prop rows='Region,Category' \
--prop cols=Quarter --prop values='Revenue:sum,Units:avg' \
--prop showDataAs=percentOfTotal
テンプレートマージ — 一度デザインし、多数を埋める
merge コマンドは、任意の .docx / .xlsx / .pptx ファイル内の {{key}} プレースホルダーをJSONデータで置き換えます — 段落、テーブルセル、図形、ヘッダー、フッター、チャートタイトル全体にわたって適用されます。エージェントはレイアウトを一度デザインし(高コスト)、本番コードがそれをN回埋め込みます(低コスト、決定的、トークンコストゼロ)。エージェントがレポートごとにゼロから生成してN個の一貫性のないレイアウトを生成してしまう失敗モードを回避します。
officecli merge invoice-template.docx out-001.docx --data '{"client":"Acme","total":"$5,200"}'
officecli merge q4-template.pptx q4-acme.pptx --data data.json
ラウンドトリップダンプ — 既存ドキュメントから学習
dump コマンドは、任意の .docx、.pptx、または .xlsx ファイル — ドキュメント全体または任意のサブツリー(単一の段落、テーブル、スライド、ワークシート、スタイルパート、ナンバリング、テーマ、または設定) — を再生可能なバッチJSONにシリアライズします。batch コマンドでそれを再生できます。ユーザーが模倣したいサンプルがある場合、エージェントは生のOOXML XMLではなく構造化された仕様を読み取り、変更し、再生します。「既存のテンプレートがある」と「100のバリエーションを生成して」というギャップを埋めます。
officecli dump existing.docx -o blueprint.json # ドキュメント全体
officecli dump existing.docx /body/tbl[1] -o table.json # 任意のサブツリー
officecli dump existing.xlsx /Sheet1 -o sheet.json # 単一のワークシート
officecli batch new.docx --input blueprint.json
常駐モードとバッチ処理
複数ステップのワークフローでは、常駐モードがドキュメントをメモリ内に保持します。バッチモードは、単一パスで複数の操作を適用します。
# 常駐モード — 名前付きパイプによるほぼゼロレイテンシ
officecli open report.docx
officecli set report.docx /body/p[1]/r[1] --prop bold=true
officecli set report.docx /body/p[2]/r[1] --prop color=FF0000
officecli close report.docx
# バッチモード — 単一パスでの複数コマンド実行(デフォルトでアトミック: 失敗した項目はバッチ全体をロールバックします)
echo '[{"command":"set","path":"/slide[1]/shape[1]","props":{"text":"Hello"}},
{"command":"set","path":"/slide[1]/shape[2]","props":{"fill":"FF0000"}}]' \
| officecli batch deck.pptx --json
# --commands でインラインバッチ(stdin不要)
officecli batch deck.pptx --commands '[{"op":"set","path":"/slide[1]/shape[1]","props":{"text":"Hi"}}]'
# 失敗しても成功したものを保持(1.0.137より前の動作)
officecli batch deck.pptx --input updates.json --best-effort --json
# 途中で停止せず、残りを実行(ただし、--best-effortと組み合わせない限りすべてロールバックされます)
officecli batch deck.pptx --input updates.json --stop-on-error --json
他のツールでファイルを読み取る場合?まずディスクにフラッシュしてください。 OfficeCLI自身の読み取り(
get/query/view)は常に最新の編集内容を確認するため、OfficeCLI内では保存する必要はありません。しかし、ライブ常駐モードはディスクへの書き込みを遅延させるため、OfficeCLI以外のプログラムがファイルを読み取る前 — python-docx/openpyxl、Microsoft Word、レンダラー、配信/アップロード — にフラッシュしてください。officecli set report.docx /body/p[1] --prop bold=true officecli save report.docx # フラッシュし、常駐モードを維持します(または `close` でフラッシュして解放) python my_reader.py report.docx # これで編集内容が反映されますライブ常駐モードは、アイドル状態がしばらく続くと自動的にフラッシュします(適応型2〜10秒、ドキュメントの測定済み保存コストに応じてスケーリング)。別のプログラムが各コマンドの後に読み取るパイプラインの場合、
OFFICECLI_RESIDENT_FLUSH=eachを設定してください — 各変更はコマンドが戻る前にディスクに書き込まれ、常駐モードは暖かく保たれます。完全なフラッシュモデル(each/auto/固定/off、save / close、環境チューニング)については、wiki → open / close を参照してください。
3層アーキテクチャ
シンプルに始め、必要に応じて深く掘り下げてください。
| レイヤー | 目的 | コマンド |
|---|---|---|
| L1: 読み取り | コンテンツのセマンティックビュー | view (テキスト、注釈付き、アウトライン、統計、問題、HTML、SVG、スクリーンショット) |
| L2: DOM | 構造化要素操作 | get、query、set、add、remove、move、swap |
| L3: 生XML | 直接XPathアクセス — 万能のフォールバック | raw、raw-set、add-part、validate |
# L1 — 高レベルビュー
officecli view report.docx annotated
officecli view budget.xlsx text --cols A,B,C --max-lines 50
# L2 — 要素レベル操作
officecli query report.docx "run:contains(TODO)"
officecli add budget.xlsx / --type sheet --prop name="Q2 Report"
officecli move report.docx /body/p[5] --to /body --index 1
# L3 — L2が十分でない場合、生のXML
officecli raw deck.pptx '/slide[1]'
officecli raw-set report.docx document \
--xpath "//w:p[1]" --action append \
--xml '<w:r><w:t>Injected text</w:t></w:r>'
AI連携
MCPサーバー
組み込みのMCPサーバー — 一つのコマンドで登録できます。
officecli mcp claude # Claude Code
officecli mcp cursor # Cursor
officecli mcp vscode # VS Code / Copilot
officecli mcp lmstudio # LM Studio
officecli mcp opencode # OpenCode
officecli mcp list # 登録状況を確認
JSON-RPC経由で全てのドキュメント操作をツールとして公開 — シェルアクセスは不要です。
直接CLI連携
OfficeCLIをAIエージェントと連携させるには2つのステップが必要です。
- バイナリのインストール — 一つのコマンド(インストールを参照)
- 完了。 OfficeCLIは、既知の設定ディレクトリをチェックすることで、AIツール(Claude Code、GitHub Copilot、Codex)を自動的に検出し、そのスキルファイルをインストールします。エージェントはすぐに任意のOfficeドキュメントを作成、読み取り、変更できるようになります。
手動セットアップ(オプション)
自動インストールが環境をカバーしない場合は、スキルファイルを手動でインストールできます。
SKILL.mdをエージェントに直接渡す:
curl -fsSL https://officecli.ai/SKILL.md
Claude Code用のローカルスキルとしてインストール:
curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md
その他のエージェント: SKILL.md の内容をエージェントのシステムプロンプトまたはツール説明に含めてください。
なぜエージェントはOfficeCLIで成功するのか
- 決定的JSON出力 — 全てのコマンドが
jsonをサポートし、一貫したスキーマを提供します。正規表現解析や標準出力のスクレイピングは不要です。 - パスベースのアドレス指定 — 全ての要素には安定したパス(
/slide[1]/shape[2])があります。エージェントはXML名前空間を理解することなくドキュメントをナビゲートできます。(OfficeCLI構文: 1ベースのインデックス、要素のローカル名 — XPathではありません。) - 段階的な複雑性(L1 → L2 → L3) — エージェントは読み取り専用ビューから開始し、DOM操作にエスカレートし、必要に応じてのみ生のXMLにフォールバックします。トークン使用量を最小限に抑えます。
- 自己修復ワークフロー —
validate、view issues、および構造化されたエラーコード(not_found、invalid_value、unsupported_property)は、提案と有効な範囲を返します。エージェントは人間の介入なしに自己修正します。 - 組み込みエージェントフレンドリーレンダリングエンジン —
view html/view screenshot/watchはHTMLとPNGをネイティブに出力します。Officeは不要です。エージェントは出力結果を「見て」、レイアウトの問題を修正できます。CI / Docker / ヘッドレス環境内でも可能です。 - 組み込み数式&ピボットエンジン — 350以上のExcel関数が書き込み時に自動評価されます(スピルダイナミック配列、財務/債券および統計ファミリーを含む)。ソース範囲から単一コマンドでネイティブOOXMLピボットテーブルを作成できます。エージェントは、Officeへのラウンドトリップなしに、計算された値と出荷された集計を即座に読み取れます。
- テンプレートマージ — エージェントはレイアウトを一度デザインし、下流のコードが
{{key}}プレースホルダーをN回埋め込みます。レポートごとにトークンを消費して再生成するのを回避します。 - ラウンドトリップダンプ —
dumpは任意の.docx、.pptx、または.xlsxを再生可能なバッチJSONに変換します。エージェントは生のOOXML XMLではなく、構造化された仕様を読み取ることで、人間が作成したサンプルから学習します。 - 組み込みヘルプ — プロパティ名や値の形式が不明な場合、エージェントは推測する代わりに
officecli <format> set <element>を実行します。 - 自動インストール — OfficeCLIはAIツール(Claude Code、Cursor、VS Codeなど)を検出し、自身を設定します。手動でのスキルファイル設定は不要です。
組み込みヘルプ
プロパティ名を推測しないでください — ヘルプをドリルダウンしてください。
officecli help pptx set # 設定可能なすべての要素とプロパティ
officecli help pptx set shape # 単一要素タイプの詳細
officecli help docx query # セレクターリファレンス: 属性、:contains、:has()など
完全な概要については officecli --help を実行してください。
JSON出力スキーマ
全てのコマンドは --json をサポートしています。一般的な応答形状:
単一要素 (get --json):
{"tag": "shape", "path": "/slide[1]/shape[1]", "attributes": {"name": "TextBox 1", "text": "Hello"}}
要素リスト (query --json):
[
{"tag": "paragraph", "path": "/body/p[1]", "attributes": {"style": "Heading1", "text": "Title"}},
{"tag": "paragraph", "path": "/body/p[5]", "attributes": {"style": "Heading1", "text": "Summary"}}
]
エラーは、非ゼロの終了コードと、エラーコード、提案、および利用可能な場合は有効な値を含む構造化されたエラーオブジェクトを返します。
{
"success": false,
"error": {
"error": "Slide 50 not found (total: 8)",
"code": "not_found",
"suggestion": "Valid Slide index range: 1-8"
}
}
エラーコード: not_found、invalid_value、unsupported_property、invalid_path、unsupported_type、missing_property、file_not_found、file_locked、invalid_selector。プロパティ名は自動修正されます — プロパティをスペルミスすると、最も近い一致の提案が返されます。
エラー回復 — エージェントは利用可能な要素を検査して自己修正します。
# エージェントが無効なパスを試行
officecli get report.docx /body/p[99] --json
# 返される: {"success": false, "error": {"error": "...", "code": "not_found", "suggestion": "..."}}
# エージェントは利用可能な要素を確認して自己修正します
officecli get report.docx /body --depth 1 --json
# 返される: 利用可能な子要素のリスト。エージェントは正しいパスを選択します。
変更の確認 (set、add、remove、move、create with --json):
{"success": true, "path": "/slide[1]/shape[1]"}
終了コード。 0 — 操作が完了しました。1 — 失敗しました(プロセスまたはビジネス上の失敗。エンベロープに error が含まれます)。2 — 注意事項付きで実行されました:unsupported_property がドロップされたか、バリデーターが警告を発しました。終了コード2は、「警告付きで完了」(success: true)と「何も適用されなかった」(success: false、例: 全てのプロパティが拒否された)の両方をカバーするため、スクリプトは終了コードだけでなく、エンベロープ内の success を読み取る必要があります。warnings[] はドロップされたものをリストします。MCPサーバーはエンベロープから同様の方法で isError を導き出します。
比較
| OfficeCLI | Microsoft Office | LibreOffice | python-docx / openpyxl | |
|---|---|---|---|---|
| オープンソース&無料 | ✓ (Apache 2.0) | ✗ (有料ライセンス) | ✓ | ✓ |
| AIネイティブCLI + JSON | ✓ | ✗ | ✗ | ✗ |
| ゼロインストール(単一バイナリ) | ✓ | ✗ | ✗ | ✗ (Python + pip) |
| どの言語からでも呼び出し可能 | ✓ (CLI) | ✗ (COM/アドイン) | ✗ (UNO API) | Pythonのみ |
| パスベースの要素アクセス | ✓ | ✗ | ✗ | ✗ |
| 生XMLフォールバック | ✓ | ✗ | ✗ | 部分的 |
| 組み込みエージェントフレンドリーレンダリングエンジン | ✓ | ✗ | ✗ | ✗ |
| ヘッドレスHTML/PNG出力 | ✓ | ✗ | 部分的 | ✗ |
テンプレートマージ({{key}})フォーマット横断 | ✓ | ✗ | ✗ | ✗ |
| ラウンドトリップダンプ → バッチJSON | ✓ | ✗ | ✗ | ✗ |
| ライブプレビュー(編集時の自動リフレッシュ) | ✓ | ✗ | ✗ | ✗ |
| ヘッドレス / CI | ✓ | ✗ | 部分的 | ✓ |
| クロスプラットフォーム | ✓ | Windows/Mac | ✓ | ✓ |
| Word + Excel + PowerPoint | ✓ | ✓ | ✓ | 別々のライブラリ |
コマンドリファレンス
| コマンド | 説明 |
|---|---|
create | 空の .docx、.xlsx、または .pptx を作成します(拡張子からタイプを判断)。 |
view | コンテンツを表示します(モード: outline、text、annotated、stats(--page-count)、issues、html、svg、screenshot、pdf(エクスポートプラグイン経由)、forms(フォーマットハンドラープラグイン経由))。docx は `--render auto |
load_skill | 特定スキルの埋め込みSKILL.mdコンテンツを表示します(インストールなし)。 |
get | 要素とその子要素を取得します(--depth N、--json)。 |
query | CSSライクなクエリ(ブール値 and/or、行ごとの列名指定(row[Salary>5000])、--find フラグ付き)。 |
set | 要素のプロパティを変更します。セレクターとExcelネイティブパス(get/query との同等性)を受け入れます。--find/--replace フラグ付き。 |
add | 要素を追加します(または --from <path> でクローン)。 |
remove | 要素を削除します。 |
move | 要素を移動します(--to <parent>、--index N、--after <path>、--before <path>)。 |
swap | 2つの要素を交換します。 |
validate | OpenXMLスキーマに対して検証します。 |
view <file> issues | ドキュメントの問題を列挙します(テキストオーバーフロー、代替テキスト不足、数式エラーなど)。 |
batch | 複数操作を単一パスで適用します(標準入力、--input、または--commands。デフォルトでアトミック — 失敗した項目はバッチ全体をロールバックします — --best-effort で部分的な進行を維持、--stop-on-error で早期中止)。 |
dump | .docx、.pptx、または .xlsx を再生可能なバッチJSONにシリアライズします(batch 経由でラウンドトリップ)。サブツリーパスを受け入れます。 |
refresh | 目次ページ番号 / PAGE / クロスリファレンスを再計算します(.docx。Windows上のWordバックエンド、ヘッドレスHTMLフォールバック)。 |
plugins | インストールされているプラグインをリスト/検査/リントします(.doc、.hwpx、.pdf エクスポートをダンプリーダー/エクスポート/フォーマットハンドラーの種類で拡張)。 |
merge | テンプレートマージ — {{key}} プレースホルダーをJSONデータで置き換えます。 |
watch | ブラウザでのライブHTMLプレビュー(編集時の自動リフレッシュ付き)。 |
mcp | AIツール連携用のMCPサーバーを開始します。 |
raw | ドキュメントパートの生のXMLを表示します。 |
raw-set | XPath経由で生のXMLを修正します。 |
add-part | 新しいドキュメントパート(ヘッダー、チャートなど)を追加します。 |
open | 常駐モードを開始します(ドキュメントをメモリ内に保持)。 |
close | 常駐モードを保存して閉じます。 |
install | バイナリ + スキル + MCPをインストールします(all、claude、cursor など)。 |
config | 設定を取得または設定します。 |
help <format> <command> | 組み込みヘルプ(例: officecli help pptx set shape)。 |
エンドツーエンドワークフロー例
典型的な自己修復エージェントワークフロー:プレゼンテーションを作成し、コンテンツを埋め込み、検証し、問題を修正します — すべて人間の介入なしに。
# 1. 作成
officecli create report.pptx
# 2. コンテンツを追加
officecli add report.pptx / --type slide --prop title="Q4 Results"
officecli add report.pptx '/slide[1]' --type shape \
--prop text="Revenue: $4.2M" --prop x=2cm --prop y=5cm --prop size=28
officecli add report.pptx / --type slide --prop title="Details"
officecli add report.pptx '/slide[2]' --type shape \
--prop text="Growth driven by new markets" --prop x=2cm --prop y=5cm
# 3. 検証
officecli view report.pptx outline
officecli validate report.pptx
# 4. 見つかった問題を修正
officecli view report.pptx issues --json
# 出力に基づいて問題を解決します。例:
officecli set report.pptx '/slide[1]/shape[1]' --prop font=Arial
単位と色
すべての寸法と色のプロパティは、柔軟な入力形式を受け入れます。
| タイプ | 受け入れられる形式 | 例 |
|---|---|---|
| 寸法 | cm、in、pt、px、または生のEMU | 2cm、1in、72pt、96px、914400 |
| 色 | 16進数、名前付き、RGB、テーマ | #FF0000、FF0000、red、rgb(255,0,0)、accent1 |
| フォントサイズ | 単純な数値またはpt接尾辞 | 14、14pt、10.5pt |
| 間隔 | pt、cm、in、または乗数 | 12pt、0.5cm、1.5x、150% |
一般的なパターン
# Wordドキュメント内のすべてのHeading1テキストを置換
officecli query report.docx "paragraph[style=Heading1]" --json | ...
officecli set report.docx /body/p[1]/r[1] --prop text="New Title"
# 全てのスライドコンテンツをJSONとしてエクスポート
officecli get deck.pptx / --depth 2 --json
# Excelセルのバルク更新
officecli batch budget.xlsx --input updates.json --json
# CSVデータをExcelシートにインポート
officecli add budget.xlsx / --type sheet --prop name="Q1 Data"
officecli import budget.xlsx "/Q1 Data" sales.csv --header
# バッチレポート用のテンプレートマージ
officecli merge invoice-template.docx invoice-001.docx --data '{"client":"Acme","total":"$5,200"}'
# 配布前のドキュメント品質チェック
officecli validate report.docx && officecli view report.docx issues --json
PythonまたはNode.jsから — 薄い常駐パイプSDK(呼び出しごとのプロセス起動なし)のいずれかをインストールします。
# Python — `pip install officecli-sdk`
import officecli
with officecli.create("deck.pptx") as doc: # または officecli.open("deck.pptx")
doc.send({"command": "add", "parent": "/", "type": "slide"})
print(doc.send({"command": "get", "path": "/slide[1]"}))
// Node.js — `npm install @officecli/sdk`
const oc = require("@officecli/sdk");
const doc = await oc.create("deck.pptx"); // または oc.open("deck.pptx")
await doc.send({ command: "add", parent: "/", type: "slide" });
console.log(await doc.send({ command: "get", path: "/slide[1]" }));
await doc.close();
どちらのSDKも、ネイティブCLIが存在しない場合に自動的にプロビジョニングします(ミラーファースト、Windows対応)そして、サイレントに行うのではなく、インストールをアナウンスします。
または、サブプロセスを直接ラップします。ワンショットです。
import json, subprocess
def cli(*args):
return json.loads(subprocess.check_output(["officecli", *args, "--json"], text=True))
cli("create", "deck.pptx")
ドキュメント
Wikiには、すべてのコマンド、要素タイプ、プロパティの詳細なガイドがあります。
- フォーマット別: Word | Excel | PowerPoint
- ワークフロー: エンドツーエンド例 — Wordレポート、Excelダッシュボード、PowerPointデッキ、バッチ変更、常駐モード
- 実行可能な例: examples/ — Word、Excel、PowerPoint用のコピー&ペーストスクリプト(.sh/.py)、出力ファイルを含む
- トラブルシューティング: 一般的なエラーと解決策
- AIエージェントガイド: Wikiをナビゲートするための決定木
ソースからビルド
コンパイルには.NET 10 SDKが必要です。出力は自己完結型のネイティブバイナリです — .NETはバイナリに埋め込まれており、実行時には不要です。
./build.sh
ライセンス
バグレポートと貢献はGitHub Issuesで歓迎します。
OfficeCLIが役立つと思われたら、GitHubでスターを付けてください — プロジェクトの発見に役立ちます。