HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

OfficeCLI: AIエージェントがMicrosoft Officeファイルを読み書きするためのOfficeスイート

OfficeCLI: Office suite for AI agents to read and edit Microsoft Office files (github.com)

200 pointsby maxloh58 コメント

要約

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]

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

🌐 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 Siliconofficecli-mac-arm64
macOS Intelofficecli-mac-x64
Linux x64officecli-linux-x64
Linux ARM64officecli-linux-arm64
Windows x64officecli-win-x64.exe
Windows ARM64officecli-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つのステップが必要です。

  1. バイナリのインストール — 一つのコマンド(インストールを参照)
  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 を導き出します。

比較

OfficeCLIMicrosoft OfficeLibreOfficepython-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)。
queryCSSライクなクエリ(ブール値 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>)。
swap2つの要素を交換します。
validateOpenXMLスキーマに対して検証します。
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プレビュー(編集時の自動リフレッシュ付き)。
mcpAIツール連携用のMCPサーバーを開始します。
rawドキュメントパートの生のXMLを表示します。
raw-setXPath経由で生の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、または生のEMU2cm、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には、すべてのコマンド、要素タイプ、プロパティの詳細なガイドがあります。

ソースからビルド

コンパイルには.NET 10 SDKが必要です。出力は自己完結型のネイティブバイナリです — .NETはバイナリに埋め込まれており、実行時には不要です。

./build.sh

ライセンス

Apache License 2.0

バグレポートと貢献はGitHub Issuesで歓迎します。


OfficeCLIが役立つと思われたら、GitHubでスターを付けてください — プロジェクトの発見に役立ちます。

OfficeCLI.AI | GitHub