ccpi入門：プラグイン管理CLIのsearchは2026年10月時点でも未実装でした

はじめに

Claude Code のプラグイン・スキルは、公式マーケットプレイス以外にもコミュニティ製の配布サイトが増えています。tonsofskills.com はその一つで、GitHub リポジトリ jeremylongshore/claude-code-plugins-plus-skills が配布元です。専用の CLI ccpi（@intentsolutionsio/ccpi）を使えば、Claude Code を開かずにシェルからプラグインを検索・インストールできると案内されています。

ただし、--help に載っているコマンドがそのまま動くとは限りません。search のような「あって当然」のコマンドが実装途中だと、CI やスケジュール実行に組み込んだ時点では気づけず、後で静かに失敗します。2026-10-15 時点の npm 最新版を入れ直し、主要コマンドを一つずつ実行して、どこまで動いてどこから未実装なのかを確認しました。

対象読者は、Claude Code のプラグインをシェルスクリプトや CI から導入しようとしている方、ccpi の導入を検討している方です。

TL;DR

• npm の最新版は 2026-10-15 時点でも 2.0.3（2026-05-21 公開）のままで、ccpi search <keyword> は「🚧 Search functionality coming soon!」を返すだけです
• リポジトリの main にある未公開の 3.0.0 のソースでも、search の処理は同じ「coming soon」表示のままでした
• analytics と install --skills も未実装です。後者だけは --help 自体に「(coming soon)」と書かれています
• マーケットプレイス未登録の状態で ccpi install <name> を実行すると、インストールしないまま exit code 0 で終わります
• doctor と list は実装済みで、診断結果は検証環境の実態と一致しました

ccpi とは何か

ccpi は npm install -g @intentsolutionsio/ccpi（README では pnpm add -g も案内）で導入する Node.js 製 CLI で、tonsofskills.com のプラグインカタログをコマンドラインから扱うためのツールです。npm レジストリの公開履歴は次のとおりです。

npm view @intentsolutionsio/ccpi time --json

{
  "created": "2025-12-26T02:43:37.053Z",
  "modified": "2026-05-21T03:17:30.635Z",
  "1.0.0": "2025-12-26T02:43:37.319Z",
  "2.0.0": "2025-12-26T03:41:56.005Z",
  "2.0.3": "2026-05-21T03:17:30.521Z"
}

2.0.3 の公開から約 5 か月、npm 上では新しい版が出ていません。以降の検証は、scratch ディレクトリにローカルインストールした 2.0.3 で行いました（コマンド例はグローバルインストール時の ccpi 表記に揃えています）。

ccpi --version
# 2.0.3

ccpi --help には install / upgrade / list / doctor / search / validate / analytics / marketplace / marketplace-add / marketplace-remove の 10 コマンドが並びます。一覧だけを見ると、一通りの機能が揃った管理ツールに見えます。

今回確認したコマンドの実装状況をまとめると、次のようになります。

upgrade・validate・marketplace-add などの残りのコマンドは、今回は実行していません。

search は 2026年10月時点でも動かない

実在しそうなキーワードで search を実行しました。

ccpi search git
echo "EXIT:$?"

Searching marketplace for: git
🚧 Search functionality coming soon!
Visit https://tonsofskills.com to browse plugins
EXIT:0

検索処理は行われず、公式サイトへのリンクを返して終わります。トップレベルの --help では search <query> Search for plugins in the marketplace と通常のコマンドとして説明されており、この制限は書かれていません。

リポジトリ側の次期版でも同じ

npm に新版が出ていないだけで、リポジトリでは修正済みという可能性もあります。そこで main ブランチの packages/cli/package.json と packages/cli/src/program.ts を raw URL で取得して確認しました。

curl -sL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/main/packages/cli/package.json \
  | python3 -c "import json,sys;print(json.load(sys.stdin)['version'])"
# 3.0.0

curl -sL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/main/packages/cli/src/program.ts \
  | grep -n -i "coming soon"

58:    .option('--skills', 'Install standalone skills (coming soon)')
127:      console.log(chalk.yellow('🚧 Search functionality coming soon!'));
147:      console.log(chalk.yellow('Analytics functionality coming soon!'));

main の CLI は 3.0.0 に上がっており、skills list-harnesses や skills doctor といったポータブルスキル向けのサブコマンドが追加されています。一方で search・analytics・install --skills の 3 か所は 2.0.3 と同じ「coming soon」のままでした。次の npm リリースを待っても、search が使えるようになる見込みはソース上からは読み取れません。

analytics と install --skills も未実装

analytics も search と同じく、コマンド一覧に注記なく載っていながら処理がありません。

ccpi analytics
echo "EXIT:$?"

Analytics functionality coming soon!
This will show plugin usage, performance, and cost metrics
EXIT:0

これに対して install --skills は、ヘルプの時点で未実装だと分かります。

ccpi install --help

Options:
  -y, --yes          Skip confirmation prompts
  --global           Install globally for all projects
  --all              Install ALL plugins from marketplace
  --skills           Install standalone skills (coming soon)
  --pack <name>      Install a plugin pack (devops, security, api, etc)
  --category <name>  Install all plugins in a category
  -h, --help         display help for command

同じ未実装でも、search と analytics はコマンド一覧上は完成済みに見え、install --skills はヘルプを読めば気づけます。同一ツール内で、未実装の申告のされ方が揃っていません。

マーケットプレイス未登録でも install の exit code は 0

ccpi install は、Claude Code 本体にマーケットプレイスが登録済みかを先に確認します。未登録の状態で実行した結果です。

ccpi install some-test-plugin -y
echo "EXIT:$?"

Installing some-test-plugin...

Marketplace not added yet

First-time setup required
...
   /plugin marketplace add jeremylongshore/claude-code-plugins

This will add access to all 259 plugins from https://tonsofskills.com
...
EXIT:0

インストールは行われていないのに、終了コードは 0（成功）です。前述の search と analytics も exit code 0 でした。シェルスクリプトや CI で「ccpi install が失敗したら止める」と組んでいても、プラグインが入らないままパイプラインが先へ進みます。

doctor と list は実装済みで、内容も正確

環境診断の doctor は、このツールで最も作り込まれたコマンドでした。

ccpi doctor

System Environment:
  ✓ Node.js Version: v22.22.0 (supported)
  ✓ Operating System: linux 6.18.44-fc-v114
  ✓ Package Managers: npm, bun, pnpm

Claude Code Installation:
  ✓ Claude Config Directory: /root/.claude
  ✓ Plugins Directory: /root/.claude/plugins
  ✓ Marketplaces Directory: /root/.claude/marketplaces

Plugins:
  ⚠ Installed Plugins: No plugins installed

Marketplace:
  ⚠ Marketplace Catalog: Not installed
    → Run with --fix to download and install the marketplace catalog

Summary:
  ✓ 8 passed
  ⚠ 2 warnings

Node.js のバージョン、Claude 設定ディレクトリの場所、マーケットプレイス未登録という検証環境の状態をそのまま言い当てています。ccpi list も「No plugins installed」と正しく報告しました。検索やインストールより、環境診断のほうが先に実装が進んでいます。

プラグイン数は取得元ごとに違う

同じカタログのプラグイン数を複数の取得元で確認すると、数字が揃いません（いずれも 2026-10-15 に取得）。

取得元	件数
GitHub リポジトリの About 欄	471 plugins（skills 3,069 / agents 347）
README の「Scale, labeled」表（raw 取得）	catalog plugins 434（skills 2,900 / agents 352）
ccpi marketplace の出力	258 plugins
ccpi install（未登録時）の案内文	259 plugins

README には「Scale, labeled」という表が追加され、件数ごとに「どの集合を数えたか」と再現コマンドが併記されるようになりました。表の冒頭には「ラベルのない件数は、スキル数を問われて 5 通りの矛盾した答えが出る原因になる」という趣旨の説明もあり、リポジトリ側も件数の不一致を認識しています。ただし CLI が表示する 258 / 259 は文字列として埋め込まれた値で、README の数字とは大きく離れたままです。紹介文などに件数を転記するときは、取得元と取得日を添えるのが安全です。

確認観点として持ち帰れること

--help に載っているかどうかは、そのコマンドが動くかどうかの判断材料になりません。ccpi では search と analytics が注記なしで一覧に載ったまま未実装で、しかもリポジトリの次期版でも状況は変わっていませんでした。初回の確認から 5 か月が経っても「coming soon」が残っているので、「そのうち実装されるだろう」という前提で自動化に組み込むのは避けたほうがよいと判断できます。

もう一つは exit code です。「未実装や前提未充足なら非ゼロで終わる」という思い込みは ccpi では通用しません。自動化に組み込むなら、exit code ではなく標準出力の固定文言（coming soon や Marketplace not added yet）で成否を判定するか、ccpi doctor の結果でマーケットプレイス登録を先に確かめる必要があります。

まとめ

• ccpi search・ccpi analytics・ccpi install --skills は、npm 最新の 2.0.3 でも、リポジトリ main の未公開 3.0.0 でも未実装です
• プラグインを探すなら、現状は tonsofskills.com のカタログ画面か、Claude Code 内の /plugin（公式ドキュメントでは Discover タブで入力検索できると説明されています）から探すのが確実です
• マーケットプレイス未登録時の ccpi install は失敗しても exit code 0 を返すため、CI では出力文字列で判定します
• プラグイン数は取得元で 258〜471 とばらつくため、転記するときは取得元と日付を明記します
• doctor / list は実装が先行しており、環境診断の用途では実用的です

ccpi を導入するかどうかは、検索 CLI としてではなく「インストールと環境診断の補助ツール」として使えるかで判断するのが現実的です。

参考リンク

• jeremylongshore/claude-code-plugins-plus-skills：リポジトリ本体（About 欄と README の Scale 表を確認）
• packages/cli/src/program.ts（main）：次期版 CLI のコマンド定義
• @intentsolutionsio/ccpi - npm：npm パッケージページ
• tonsofskills.com：プラグインカタログのブラウズサイト
• Discover and install plugins - Claude Code Docs：/plugin の Discover タブで検索できる旨の記載を確認