cli-anything

cli-anything — あらゆるソフトウェアをエージェントネイティブに

CLI-Anything（HKUDS）は、AI エージェントと世界中のソフトウェアをつなぎます。壊れやすいGUI自動化の代わりに、 実際のアプリケーション（Blender、GIMP、LibreOffice、OBS、Godot、QGIS、…）を、 構造化されたエージェント優先のCLIでラップします。Clickコマンド、ステートフルなREPL、--json 出力、元に戻す／やり直し機能を備え、7段階のパイプラインで生成・検証されます。 40以上のハーネスで2,461件のテストに合格しています。このスキルはルーティングを優先するラッパーです。適切なモードを選び、適切なインターフェースをインストールして、 ビルド → 改善 → 検証のループを進めます。

このスキルを使う場面

• ユーザーが、スクリーンショットやRPAではなくCLIを使って、実際のソフトウェア（画像／動画／音声編集、オフィス、3D、GIS、ゲームエンジン、図表作成、ストリーミング）をエージェントに操作させたい
• ユーザーがcli-anything-hubのインストールやcli-hubの使用を求めている （list、search、info、install、update、uninstall、launch）
• ユーザーがCLI-Hubメタスキルを介して、エージェントにCLIsを自律的に見つけてインストールさせたい
• ユーザーが/cli-anythingを使ってローカルのコードベースまたはGitHubリポジトリから新しいCLIハーネスを生成したい、またはClaude Code、Codex、OpenCode、OpenClaw、Pi、Hermes、Qodercli、GitHub Copilot CLI向けのCLI-Anythingプラグイン／スキルのインストール方法を尋ねている
• ユーザーが/cli-anything:refine、/cli-anything:test、/cli-anything:validateを使って既存のハーネスを拡張または検証したい

このスキルを使わない場面

• ユーザーがソフトウェアCLIラッパーではなく、特定ドメイン向けのエージェントチーム（エージェント＋スキルの足場）を設計したい → harness2を使用
• ユーザーがClaudeプラグイン全般を閲覧／インストールしている → ccpi-marketplaceを使用
• 対象にコードベースもAPIもなく、実際のブラウザー／GUIセッションを通じて操作する必要がある → browser-harness（すでに開いているブラウザーにはplaywriter）を使用
• ユーザーが必要としているのはウェブスクレイピング／抽出だけ → scraplingを使用

前提条件

要件	備考
Python 3.10+	CLI-Hubと生成されるハーネスはPython／Clickベースです
対象ソフトウェア	ハーネスは実際のバックエンドを呼び出すため、上流のアプリケーション（GIMP、Blender、…）もインストールしてください
最先端のコーディングエージェント	ハーネスの生成には高性能モデル（Claude Opus／Sonnetクラス）が必要です。性能の低いモデルでは品質が低下します
ソースコードへのアクセス	7段階のジェネレーターはソースコードを使います。バイナリのみの対象では品質が大幅に低下します

手順

ステップ1 — モードを選ぶ

モード	場面	エントリーポイント
エコシステムを使う	すぐに使えるハーネスがある可能性が高い	pip install cli-anything-hub → cli-hub search <kw>
エージェントを強化する	エージェント自身にCLIを選択／インストールさせる	npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y
ハーネスを生成する	レジストリがそのソフトウェアを網羅していない	プラットフォームのプラグイン／スキル → /cli-anything <path-or-repo>
ハーネスを反復改善する	対応範囲の不足、フローの失敗	/cli-anything:refine · :test · :validate

まずレジストリを確認してください。ビルドは代替手段であり、既定の方法ではありません。

ステップ2 — CLI-Hubでエコシステムを使う

pip install cli-anything-hub

cli-hub list                 # browse the registry
cli-hub search image         # search by keyword
cli-hub info gimp            # inspect one CLI
cli-hub install gimp         # install from CLI-Hub
cli-hub launch gimp          # run an installed CLI
cli-hub update gimp          # update
cli-hub uninstall gimp       # remove

CLI-Hub v0.2.0+では、public_registry.jsonを介して複数のインストール元 （pip、npm、brew、同梱／システムツール）から公開CLIも提供されます。 ハーネスがデスクトップソフトウェア（GIMP、Blender、LibreOffice、…）をラップする場合は、 その上流アプリケーションもインストールしてください。

ステップ3 — エージェントにメタスキルを与える

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

続いて、エージェントに次のプロンプトを入力します。

Find appropriate CLI software in CLI-Hub and complete the task: ...

Claude Code、Codex、OpenClaw、Nanobot、Antigravityなど、SKILL互換のエージェントで動作します。 モノレポ内のハーネス別スキルも検出できます。npx skills add HKUDS/CLI-Anything --list。

ステップ 4 — 新しいハーネスを生成する（7 フェーズのパイプライン）

Claude Code（主要プラットフォーム）：

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

/cli-anything ./gimp                              # local source
/cli-anything https://github.com/blender/blender  # GitHub repo

パイプラインは次のとおりです：1 分析 → 2 設計 → 3 実装（Click CLI ＋ REPL ＋ JSON ＋ 元に戻す／やり直す）→ 4 テストを計画 → 5 テストを作成 → 6 ドキュメントを作成（＋ フェーズ 6.5 SKILL.md 生成）→ 7 公開（setup.py、PATH へのインストール）。 その他のプラットフォーム（Codex、OpenCode、OpenClaw、Pi、Hermes、Qodercli、Copilot CLI、Goose）も同じ方法に従います。インストールコマンドは references/commands.md にあります。

/cli-anything が認識されない場合は、/reload-plugins を実行し、/help cli-anything で確認してから、 マーケットプレイスから再インストールしてください。古い ビルドの場合に限り、従来の /cli-anything:cli-anything 形式をお試しください。

ステップ 5 — 改良、テスト、検証

/cli-anything:refine ./gimp                                  # broad gap analysis
/cli-anything:refine ./gimp "batch processing and filters"   # focused
/cli-anything:test ./gimp                                    # run tests, update TEST.md
/cli-anything:validate ./gimp                                # check against HARNESS.md

改良は段階的かつ非破壊的です。繰り返し実行して、カバレッジを 本番品質に近づけてください。HARNESS.md は、バリデーターが照合する 方法論の SOP（信頼できる唯一の情報源）です。

ステップ 6 — 生成した CLI を使用する

cd <software>/agent-harness && pip install -e .

cli-anything-gimp --help                     # discoverable via --help/which
cli-anything-gimp --json layer add -n "BG"   # structured output for agents
cli-anything-gimp                            # bare command → stateful REPL

すべてのハーネスには、2 つのモード（REPL ＋ サブコマンド）、すべての コマンドでの --json 対応、生成された SKILL.md（skills/cli-anything-<name>/SKILL.md）が含まれます。

ステップ 7 — jeo-skills と並行してプラグイン形式でインストールする

このスキルフォルダーは、標準の jeo-skills の フローを通じてプラグインとしてインストールできます。これにより、ラッパー、リファレンス、インストーラースクリプトが ディスクに配置され、対応するあらゆるエージェントランタイムで利用できます。

# Project install (writes into .agents/skills/cli-anything/)
npx skills add https://github.com/akillness/jeo-skills --skill cli-anything

# Global install for every detected agent
npx skills add -g https://github.com/akillness/jeo-skills --skill cli-anything

# Target specific agents
npx skills add -g https://github.com/akillness/jeo-skills --skill cli-anything -a claude-code -a codex -y

このスキルには、scripts/install.sh も含まれます。これは ワンショットの CLI-Hub インストーラー（venv 対応の uv／pip 選択、PEP 668 対応）で、 CLI_ANYTHING_META_SKILL=1 を指定するとメタスキルもインストールできます。

出力形式

ユーザーが cli-anything にヘルプを求めた場合は、簡潔な概要を返します。

# cli-anything Routing Brief

## Scope
- Mode: use-ecosystem | empower-agents | generate-harness | iterate-harness
- Target software: <name or repo> | undecided
- Agent platform: claude | codex | opencode | openclaw | pi | hermes | copilot | other

## Recommended next move
- install-cli-hub | cli-hub-search | install-meta-skill | install-platform-plugin | run-/cli-anything | refine | test | validate

## Why
- 2-3 bullets grounded in the user's packet

## Route-outs
- `harness2` for agent-team and agent-harness design (not software wrappers)
- `browser-harness` for no-codebase GUI/browser targets
- `ccpi-marketplace` for general Claude plugin browsing

ベストプラクティス

1. 生成前にレジストリを検索する — すでに 40 以上のハーネスが存在します。 cli-hub search は数秒で済みますが、7 フェーズのビルドには 1 セッションかかります。
2. 実際のバックエンドをインストールする — ハーネスは依存関係に妥協することなく実際のソフトウェアを呼び出します。バックエンドがない場合、テストはスキップではなく失敗します。
3. エージェントでの利用には --json を使う — すべてのコマンドが対応しています。 人間が読みやすいテーブルはデバッグ専用です。
4. 終了コードではなく出力を検証する — この方法論ではマジックバイト、 ZIP／OOXML 構造、ピクセル／音声解析をチェックします。アーティファクトでも同様に確認してください。
5. /cli-anything:refine を繰り返し実行する — 1 回の生成では、すべての機能をカバーできないことがほとんどです。各改良実行は段階的に進みます。
6. Windows では bash が必要です — Git for Windows（bash ＋ cygpath）をインストールするか、プラグインコマンドを実行する前に WSL を使用してください。

リファレンス

• 上流リポジトリ：https://github.com/HKUDS/CLI-Anything
• CLI-Hub（ウェブ）：https://hkuds.github.io/CLI-Anything/
• 方法論 SOP：cli-anything-plugin/HARNESS.md
• クイックスタート：cli-anything-plugin/QUICKSTART.md
• 公開ガイド：cli-anything-plugin/PUBLISHING.md
• 技術レポート：https://arxiv.org/abs/2606.03854
• インストーラースクリプト：scripts/install.sh
• コマンドおよびプラットフォームのリファレンス：references/commands.md
• 関連スキル：../harness2/SKILL.md、../ccpi-marketplace/SKILL.md、 ../browser-harness/SKILL.md、../scrapling/SKILL.md
• ライセンス：Apache-2.0（上流の LICENSE を参照）