npm-axi について
npm-axiは公開npm registryを読み取り専用で操作するコマンドラインインターフェースです。エージェント向けに簡潔なTOON形式で出力し、認証なしでパッケージやメタデータ、バージョン、ダウンロード数を調べられます。
主な機能
- 01検索結果数付きのパッケージ検索
- 02READMEのプレビューと全文表示
- 03最近のバージョンとlatestタグの表示
- 04週次・月次ダウンロード数の確認
- 05ヘルプ付き構造化TOONエラー
活用シーン
- 01プロジェクト用npmパッケージの検索
- 02採用前のパッケージメタデータ確認
- 03最近のパッケージリリースの比較
- 04パッケージのダウンロード状況の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ssbrouhard/ npm-axi --skill npm-axiインストール後、Claude Code で/npm-axiを入力して読み込まれたか確認します。
詳細
npm-axi
npm-axi は、公開 npm レジストリ向けの AXI です。エージェント向けに設計された、トークン効率の高い TOON 出力を返します。読み取り専用で、認証は不要です。
グローバルインストールせずに実行する方法:
npx -y npm-axi <command> [args] [flags]
コマンド
search — パッケージを検索
npx -y npm-axi search "react router" --limit 20
最小限の name,version,description テーブルと、一致件数の合計を返します:
count: 20 of 1240 total
packages[20]{name,version,description}:
react-router,7.1.1,Declarative routing for React
...
view — パッケージの詳細
npx -y npm-axi view zod # preview README
npx -y npm-axi view zod --full # complete README
事前に計算された集計値(依存関係の数、週間ダウンロード数)と、サイズの目安付きで省略された README が含まれます:
package:
name: zod
version: 3.24.1
license: MIT
description: TypeScript-first schema declaration and validation library
dependencies: 0
weeklyDownloads: 24500000
homepage: https://zod.dev
repository: https://github.com/colinhacks/zod
published: 2024-12-30
readme: First 800 chars...
readmeChars: 5421
help[1]: Run `npm-axi view zod --full` to see complete README
versions — 最近のバージョン
npx -y npm-axi versions typescript --limit 15
新しい順に、latest dist-tag とバージョン数の合計を表示します。
downloads — ダウンロード統計
npx -y npm-axi downloads express
downloads:
package: express
lastWeek: 30000000
lastMonth: 120000000
補足
- エラーは、対処方法を示す
help行とともに、構造化された TOON として stdout に返されます。 - 終了コード:成功は
0、エラー(パッケージが見つからない場合など)は1、使用方法のエラーは2です。 - 不明なパッケージに対しては、
searchを提案するNOT_FOUNDエラーが返されます。
コメント
Markdown 対応