README JA

CLI-Anything: AIエージェントと世界のソフトウェアの架け橋</strong>

<a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"></a> <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"></a>

ワンコマンド: あらゆるソフトウェアをOpenClaw、nanobot、Cursor、Claude Codeなどのエージェント対応に。  English | 中文文档

🤔 なぜCLIなのか？

CLIは人間とAIエージェント両方にとって普遍的なインターフェースです：

• 構造化 & 組み合わせ可能 - テキストコマンドはLLMのフォーマットに適合し、複雑なワークフローのために連鎖可能

• 軽量 & 汎用的 - 最小限のオーバーヘッドで、依存関係なくすべてのシステムで動作

• 自己記述的 - --helpフラグがエージェントが発見できる自動ドキュメントを提供

• 実証済みの成功 - Claude Codeは毎日何千もの実際のワークフローをCLIを通じて実行

• エージェントファースト設計 - 構造化されたJSON出力がパース処理の複雑さを排除

• 決定論的 & 信頼性 - 一貫した結果が予測可能なエージェントの動作を実現

🚀 クイックスタート

前提条件

• Python 3.10+
• 対象ソフトウェアがインストール済みであること（例：GIMP、Blender、LibreOffice、または独自のアプリケーション）
• サポートされているAIコーディングエージェント: Claude Code | OpenClaw | OpenCode | Codex | Qodercli | その他のプラットフォーム

プラットフォームを選択

ステップ1: マーケットプレイスの追加

CLI-AnythingはGitHub上でホストされるClaude Codeプラグインマーケットプレイスとして配布されています。

# CLI-Anythingマーケットプレイスを追加
/plugin marketplace add HKUDS/CLI-Anything

ステップ2: プラグインのインストール

# マーケットプレイスからcli-anythingプラグインをインストール
/plugin install cli-anything

これで完了です。プラグインがClaude Codeセッションで利用可能になります。

ステップ3: ワンコマンドでCLIを構築

# /cli-anything:cli-anything <ソフトウェアのパスまたはリポジトリ>
# GIMPの完全なCLIを生成（全7フェーズ）
/cli-anything:cli-anything ./gimp

# 注: Claude Codeが2.x未満の場合は、"/cli-anything"を代わりに使用してください。

これにより完全なパイプラインが実行されます：

1. 🔍 分析 — ソースコードをスキャンし、GUIアクションをAPIにマッピング
2. 📐 設計 — コマンドグループ、状態モデル、出力フォーマットを設計
3. 🔨 実装 — REPL、JSON出力、アンドゥ/リドゥ機能を備えたClick CLIを構築
4. 📋 テスト計画 — ユニットテスト + E2Eテスト計画のTEST.mdを作成
5. 🧪 テスト作成 — 包括的なテストスイートを実装
6. 📝 ドキュメント — TEST.mdを結果で更新
7. 📦 公開 — setup.pyを作成し、PATHにインストール

ステップ4（オプション）: CLIの改善と拡張

初回ビルド後、CLIを反復的に改善してカバレッジを拡大し、不足している機能を追加できます：

# 広範な改善 — エージェントがすべての機能のギャップを分析
/cli-anything:refine ./gimp

# 集中的な改善 — 特定の機能領域をターゲット
/cli-anything:refine ./gimp "画像のバッチ処理とフィルタのCLIを追加したい"

refineコマンドは、ソフトウェアの全機能と現在のCLIカバレッジの間のギャップ分析を行い、特定されたギャップに対して新しいコマンド、テスト、ドキュメントを実装します。複数回実行してカバレッジを着実に拡大できます — 各実行はインクリメンタルで非破壊的です。

マーケットプレイスを使用しない場合：

# リポジトリをクローン
git clone https://github.com/HKUDS/CLI-Anything.git

# プラグインをClaude Codeのプラグインディレクトリにコピー
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything

# プラグインをリロード
/reload-plugins

ステップ1: コマンドのインストール

CLI-Anythingのコマンドと HARNESS.md をOpenCodeのコマンドディレクトリにコピーします：

# リポジトリをクローン
git clone https://github.com/HKUDS/CLI-Anything.git

# グローバルインストール（すべてのプロジェクトで利用可能）
cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/

# またはプロジェクトレベルのインストール
cp CLI-Anything/opencode-commands/*.md .opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/

注: HARNESS.mdはすべてのコマンドが参照する方法論の仕様書です。コマンドと同じディレクトリに配置する必要があります。

これにより5つのスラッシュコマンドが追加されます: /cli-anything、/cli-anything-refine、/cli-anything-test、/cli-anything-validate、/cli-anything-list。

ステップ2: ワンコマンドでCLIを構築

# GIMPの完全なCLIを生成（全7フェーズ）
/cli-anything ./gimp

# GitHubリポジトリからビルド
/cli-anything https://github.com/blender/blender

コマンドはサブタスクとして実行され、Claude Codeと同じ7フェーズの方法論に従います。

ステップ3（オプション）: CLIの改善と拡張

# 広範な改善 — エージェントがすべての機能のギャップを分析
/cli-anything-refine ./gimp

# 集中的な改善 — 特定の機能領域をターゲット
/cli-anything-refine ./gimp "バッチ処理とフィルタ"

ステップ1: プラグインの登録

git clone https://github.com/HKUDS/CLI-Anything.git
bash CLI-Anything/qoder-plugin/setup-qodercli.sh

これにより~/.qoder.jsonにcli-anythingプラグインが登録されます。登録後、新しいQodercliセッションを開始してください。

ステップ2: QodercliからCLI-Anythingを使用

/cli-anything:cli-anything ./gimp
/cli-anything:refine ./gimp "バッチ処理とフィルタ"
/cli-anything:validate ./gimp

ステップ1: スキルのインストール

CLI-Anything はネイティブな OpenClaw SKILL.md ファイルを提供しています。OpenClaw のスキルディレクトリにコピーしてください：

# リポジトリをクローン
git clone https://github.com/HKUDS/CLI-Anything.git

# グローバルスキルフォルダにインストール
mkdir -p ~/.openclaw/skills/cli-anything
cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md

ステップ2: CLIの構築

インストール後、OpenClaw 内で以下のようにスキルを呼び出せます：

@cli-anything build a CLI for ./gimp

このスキルは Claude Code や OpenCode と同じ7段階の方法論に従っています。

ステップ1: スキルのインストール

同梱のインストーラーを実行します：

# リポジトリをクローン
git clone https://github.com/HKUDS/CLI-Anything.git

# スキルをインストール
bash CLI-Anything/codex-skill/scripts/install.sh

Windows PowerShellの場合：

.\CLI-Anything\codex-skill\scripts\install.ps1

これにより$CODEX_HOME/skills/cli-anything（CODEX_HOMEが未設定の場合は~/.codex/skills/cli-anything）にスキルがインストールされます。

インストール後、検出されるようにCodexを再起動してください。

ステップ2: CodexからCLI-Anythingを使用

自然言語でタスクを説明します。例：

CLI-Anythingを使って./gimpのハーネスを構築して
CLI-Anythingを使って./shotcutのピクチャーインピクチャーワークフローを改善して
CLI-Anythingを使って./libreofficeを検証して

CodexスキルはClaude CodeプラグインおよびOpenCodeコマンドと同じ方法論を適用しつつ、生成されるPythonハーネスのフォーマットは変更されません。

CLI-Anythingはプラットフォーム非依存で設計されています。より多くのAIコーディングエージェントのサポートを予定しています：

• Codex — codex-skill/ 内の同梱スキルで利用可能
• Cursor — 近日公開
• Windsurf — 近日公開
• お好みのツール — コントリビューション歓迎！リファレンス実装についてはopencode-commands/ディレクトリをご覧ください。

生成されたCLIの使用

どのプラットフォームでビルドしても、生成されたCLIは同じ方法で動作します：

# PATHにインストール
cd gimp/agent-harness && pip install -e .

# どこからでも使用可能
cli-anything-gimp --help
cli-anything-gimp project new --width 1920 --height 1080 -o poster.json
cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e"

# インタラクティブREPLに入る
cli-anything-gimp

💡 CLI-Anythingのビジョン: エージェントネイティブソフトウェアの構築

• 🌐 ユニバーサルアクセス - すべてのソフトウェアが構造化されたCLIを通じて即座にエージェント制御可能に。

• 🔗 シームレスな統合 - エージェントがAPI、GUI、再構築、複雑なラッパーなしにあらゆるアプリケーションを制御。

• 🚀 未来志向のエコシステム - ワンコマンドで人間向けに設計されたソフトウェアをエージェントネイティブツールに変換。

🔧 CLI-Anythingの活用シーン

CLI-Anythingの主な特徴

エージェントとソフトウェアのギャップ

AIエージェントは推論には優れていますが、実際のプロフェッショナルソフトウェアの操作は苦手です。現在のソリューションは脆弱なUI自動化、限定的なAPI、または機能の90%を失う簡素化された再実装です。

CLI-Anythingの解決策: あらゆるプロフェッショナルソフトウェアを機能を損なうことなくエージェントネイティブツールに変換。

🎯 CLI-Anythingで何ができる？

🛠️ エージェントにワークフローを任せる

プロフェッショナルでも日常でも — コードベースを/cli-anythingに渡すだけ。クリエイティブ作業にはGIMP、Blender、Shotcut。日常タスクにはLibreOffice、OBS Studio。ソースがない？オープンソースの代替を見つけてそれを渡しましょう。エージェントが使える完全なCLIが即座に手に入ります。

🔗 散在するAPIを1つのCLIに統合

断片化されたWebサービスAPIの管理にうんざりしていませんか？ドキュメントやSDKの原稿を/cli-anythingに渡せば、エージェントが個々のエンドポイントを一貫したコマンドグループにまとめた強力でステートフルなCLIを手に入れます。数十のAPIコール代わりに1つのツール — トークンを節約しながらより強力な機能を。

🚀 GUIエージェントの置き換えまたは強化

CLI-AnythingはGUIベースのエージェントアプローチを完全に置き換え可能 — スクリーンショットも脆弱なピクセルクリックも不要。さらに面白いのは：ソフトウェアを/cli-anythingすれば、コードとターミナルだけでエージェントタスク、評価器、ベンチマークを合成できます — 完全自動化、反復改善可能、圧倒的に効率的。

✨ ⚙️ CLI-Anythingの仕組み

🏗️ 完全自動化された7フェーズパイプライン

コードベース分析からPyPI公開まで — プラグインがアーキテクチャ設計、実装、テスト計画、テスト作成、ドキュメンテーションを完全に自動で処理します。

🎯 本物のソフトウェア統合

実際のレンダリングのための実アプリケーションへの直接呼び出し。LibreOfficeがPDFを生成し、Blenderが3Dシーンをレンダリングし、Audacityがsoxを通じてオーディオを処理します。妥協ゼロ、おもちゃの実装ゼロ。

🔁 スマートセッション管理

アンドゥ/リドゥ機能を備えた永続的なプロジェクト状態と、すべてのCLIで一貫したインタラクティブ体験を提供する統合REPLインターフェース（ReplSkin）。

📦 設定不要のインストール

シンプルな pip install -e . で cli-anything-<software> がPATHに直接追加されます。エージェントは標準的なwhichコマンドでツールを発見します。セットアップ不要、ラッパー不要。

🧪 プロダクショングレードのテスト

多層的な検証: 合成データによるユニットテスト、実際のファイルとソフトウェアによるエンドツーエンドテスト、さらにインストール済みコマンドのCLIサブプロセス検証。

🐍 クリーンなパッケージアーキテクチャ

すべてのCLIがcli_anything.*名前空間で整理 — 競合なし、pip installable、一貫した命名規則: cli-anything-gimp、cli-anything-blenderなど。

🎬 デモンストレーション

🎯 汎用

CLI-Anythingはコードベースを持つあらゆるソフトウェアで動作します — ドメインの制限やアーキテクチャの制約はありません。

🏭 プロフェッショナルグレードのテスト

クリエイティブ、生産性、コミュニケーション、ダイアグラム、AIコンテンツ生成など、以前はAIエージェントがアクセスできなかった11の多様で複雑なアプリケーションでテスト済み。

🎨 多様なドメインカバレッジ

クリエイティブワークフロー（画像編集、3Dモデリング、ベクターグラフィックス）からプロダクションツール（オーディオ、オフィス、ライブストリーミング、動画編集）まで。

✅ 完全なCLI生成

各アプリケーションに対して完全な本番対応のCLIインターフェースを生成 — デモではなく、全機能へのアクセスを保持した包括的なツールアクセス。

全1,508テストで100%パス — 1,073ユニットテスト + 435エンドツーエンドテスト。

📊 テスト結果

各CLIハーネスは本番環境の信頼性を確保するために厳格な多層テストを実施しています：

================================ テストサマリー ================================
gimp          107 passed  ✅   (64 unit + 43 e2e)
blender       208 passed  ✅   (150 unit + 58 e2e)
inkscape      202 passed  ✅   (148 unit + 54 e2e)
audacity      161 passed  ✅   (107 unit + 54 e2e)
libreoffice   158 passed  ✅   (89 unit + 69 e2e)
obs-studio    153 passed  ✅   (116 unit + 37 e2e)
kdenlive      155 passed  ✅   (111 unit + 44 e2e)
shotcut       154 passed  ✅   (110 unit + 44 e2e)
zoom           22 passed  ✅   (22 unit + 0 e2e)
drawio        138 passed  ✅   (116 unit + 22 e2e)
anygen         50 passed  ✅   (40 unit + 10 e2e)
──────────────────────────────────────────────────────────────────────────────
合計         1,508 passed  ✅   100% パス率

🏗️ CLI-Anythingのアーキテクチャ

🎯 コア設計原則

1. 本物のソフトウェア統合 — CLIは有効なプロジェクトファイル（ODF、MLT XML、SVG）を生成し、レンダリングを実際のアプリケーションに委譲します。ソフトウェアの代替ではなく、ソフトウェアへの構造化インターフェースを構築します。

2. 柔軟なインタラクションモデル — すべてのCLIがデュアルモードで動作: インタラクティブなエージェントセッション用のステートフルREPL + スクリプティング/パイプライン用のサブコマンドインターフェース。素のコマンドを実行 → REPLモードに入る。

3. 一貫したユーザー体験 — すべての生成CLIがブランドバナー、スタイル付きプロンプト、コマンド履歴、進捗表示、標準化されたフォーマットを持つ統合REPLインターフェース（repl_skin.py）を共有。

4. エージェントネイティブ設計 — すべてのコマンドに組み込みの--jsonフラグがマシン向けの構造化データを提供し、人間が読めるテーブルがインタラクティブ用途に対応。エージェントは標準の--helpとwhichコマンドで機能を発見。

5. 妥協なしの依存関係 — 実際のソフトウェアは必須要件です — フォールバックなし、グレースフルデグラデーションなし。バックエンドが見つからない場合、テストはスキップではなく失敗し、本物の機能を保証します。

📂 プロジェクト構造

cli-anything/
├── 📄 README.md                          # 英語版README
├── 📁 assets/                            # 画像とメディア
│   ├── icon.png                          # プロジェクトアイコン
│   └── teaser.png                        # ティーザー画像
│
├── 🔌 cli-anything-plugin/               # Claude Codeプラグイン
│   ├── HARNESS.md                        # 方法論SOP（信頼できる唯一の情報源）
│   ├── README.md                         # プラグインドキュメント
│   ├── QUICKSTART.md                     # 5分で始めるガイド
│   ├── PUBLISHING.md                     # 配布ガイド
│   ├── repl_skin.py                      # 統合REPLインターフェース
│   ├── commands/                         # プラグインコマンド定義
│   │   ├── cli-anything.md               # メインビルドコマンド
│   │   ├── refine.md                     # 既存ハーネスカバレッジの拡張
│   │   ├── test.md                       # テストランナー
│   │   └── validate.md                   # 標準検証
│   └── scripts/
│       └── setup-cli-anything.sh         # セットアップスクリプト
│
├── 🤖 codex-skill/                      # Codexスキルエントリーポイント
├── 🎨 gimp/agent-harness/               # GIMP CLI (107テスト)
├── 🧊 blender/agent-harness/            # Blender CLI (208テスト)
├── ✏️ inkscape/agent-harness/            # Inkscape CLI (202テスト)
├── 🎵 audacity/agent-harness/           # Audacity CLI (161テスト)
├── 📄 libreoffice/agent-harness/        # LibreOffice CLI (158テスト)
├── 📹 obs-studio/agent-harness/         # OBS Studio CLI (153テスト)
├── 🎞️ kdenlive/agent-harness/           # Kdenlive CLI (155テスト)
├── 🎬 shotcut/agent-harness/            # Shotcut CLI (154テスト)
├── 📞 zoom/agent-harness/               # Zoom CLI (22テスト)
├── 📐 drawio/agent-harness/             # Draw.io CLI (138テスト)
└── ✨ anygen/agent-harness/             # AnyGen CLI (50テスト)

各agent-harness/にはClick CLI、コアモジュール、ユーティリティ（repl_skin.pyとバックエンドラッパーを含む）、包括的なテストを備えたcli_anything.<software>/配下のインストール可能なPythonパッケージが含まれています。

🎯 プラグインコマンド

使用例

# ローカルソースからGIMPの完全なCLIを構築
/cli-anything /home/user/gimp

# GitHubリポジトリからビルド
/cli-anything https://github.com/blender/blender

# 既存のハーネスを改善 — 広範なギャップ分析
/cli-anything:refine /home/user/gimp

# 特定のフォーカスエリアで改善
/cli-anything:refine /home/user/shotcut "ビデオインビデオとピクチャーインピクチャーの合成"

# テストを実行しTEST.mdを更新
/cli-anything:test /home/user/inkscape

# HARNESS.md標準に対して検証
/cli-anything:validate /home/user/audacity

🎮 デモ: 生成されたCLIの使用

cli-anything-libreofficeでエージェントができることの例：

# 新しいWriterドキュメントを作成
$ cli-anything-libreoffice document new -o report.json --type writer
✓ Writerドキュメントを作成: report.json

# コンテンツを追加
$ cli-anything-libreoffice --project report.json writer add-heading -t "Q1レポート" --level 1
✓ 見出しを追加: "Q1レポート"

$ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3
✓ 4×3テーブルを追加

# LibreOfficeヘッドレスで実際のPDFにエクスポート
$ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite
✓ エクスポート完了: output.pdf (42,831 bytes) via libreoffice-headless

# エージェント用のJSONモード
$ cli-anything-libreoffice --json document info --project report.json
{
  "name": "Q1 Report",
  "type": "writer",
  "pages": 1,
  "elements": 2,
  "modified": true
}

REPLモード

$ cli-anything-blender
╔══════════════════════════════════════════╗
║       cli-anything-blender v1.0.0       ║
║     Blender CLI for AI Agents           ║
╚══════════════════════════════════════════╝

blender> scene new --name ProductShot
✓ シーンを作成: ProductShot

blender[ProductShot]> object add-mesh --type cube --location 0 0 1
✓ メッシュを追加: Cube at (0, 0, 1)

blender[ProductShot]*> render execute --output render.png --engine CYCLES
✓ レンダリング完了: render.png (1920×1080, 2.3 MB) via blender --background

blender[ProductShot]> exit
Goodbye! 👋

📖 標準プレイブック: HARNESS.md

HARNESS.mdは、自動CLI生成によってあらゆるソフトウェアをエージェントアクセス可能にするための決定版SOPです。

自動生成プロセスを通じて洗練された実証済みのパターンと方法論をエンコードしています。

このプレイブックは、11の多様な本番対応ハーネスの構築から得られた主要な知見を集約しています。

重要な教訓

完全な方法論はこちら: cli-anything-plugin/HARNESS.md

📦 インストール & 使用方法

プラグインユーザー向け（Claude Code）

# マーケットプレイスの追加とインストール（推奨）
/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

# 任意のコードベースを持つソフトウェアのCLIを構築
/cli-anything <ソフトウェア名>

生成されたCLI向け

# 生成されたCLIをインストール
cd <software>/agent-harness
pip install -e .

# 確認
which cli-anything-<software>

# 使用
cli-anything-<software> --help
cli-anything-<software>                    # REPLに入る
cli-anything-<software> --json <command>   # エージェント用JSON出力

テストの実行

# 特定のCLIのテストを実行
cd <software>/agent-harness
python3 -m pytest cli_anything/<software>/tests/ -v

# force-installedモード（検証に推奨）
CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<software>/tests/ -v -s

🤝 コントリビューション

コントリビューションを歓迎します！CLI-Anythingは拡張可能に設計されています：

• 新しいソフトウェアターゲット — プラグインを使用して任意のコードベースのCLIを生成し、cli-anything-plugin/PUBLISHING.mdを通じてハーネスを提出してください。
• 方法論の改善 — 新しい教訓をエンコードしたHARNESS.mdへのPR
• プラグインの強化 — 新しいコマンド、フェーズの改善、より良い検証
• テストカバレッジ — より多くのE2Eシナリオ、エッジケース、ワークフローテスト

制限事項

• 強力な基盤モデルが必要 — CLI-Anythingは信頼性のあるハーネス生成のためにフロンティアクラスのモデル（例：Claude Opus 4.6、Claude Sonnet 4.6、GPT-5.4）に依存しています。弱いまたは小さいモデルでは、大幅な手動修正が必要な不完全または不正確なCLIが生成される可能性があります。
• 利用可能なソースコードに依存 — 7フェーズパイプラインはソースコードから分析・生成します。対象ソフトウェアがデコンパイルが必要なコンパイル済みバイナリのみを提供する場合、ハーネスの品質とカバレッジは大幅に低下します。
• 反復的な改善が必要な場合がある — 1回の/cli-anything実行ですべての機能を完全にカバーできないことがあります。CLIのパフォーマンスとカバレッジを本番品質にするためには、/refineを1回以上実行することがしばしば必要です。

ロードマップ

• より多くのアプリケーションカテゴリのサポート（CAD、DAW、IDE、EDA、科学ツール）
• エージェントタスク完了率のベンチマークスイート
• 社内/カスタムソフトウェア向けコミュニティ提供CLIハーネス
• Claude Code以外の追加エージェントフレームワークとの統合
• クローズドソースソフトウェアとWebサービスのAPIをCLIにパッケージ化するサポート
• エージェントスキルの発見とオーケストレーション用のSKILL.mdをCLIと共に生成

📖 ドキュメント

各生成ハーネスにも以下が含まれます：

• <SOFTWARE>.md — そのアプリケーション固有のアーキテクチャSOP
• tests/TEST.md — テスト計画と結果のドキュメント

⭐ スター履歴

CLI-Anythingがあなたのソフトウェアをエージェントネイティブにするのに役立ったら、スターをお願いします！ ⭐

</picture>

📄 ライセンス

MITライセンス — 自由に使用、変更、配布できます。

CLI-Anything — コードベースを持つあらゆるソフトウェアをエージェントネイティブに。

_{AIエージェント時代のための方法論 | 11のプロフェッショナルソフトウェアデモ | 1,508のパステスト}