パッケージ

パッケージは、Blender、SuperColliderによる音楽、プロジェクトのナレッジベース、Tripoの3D生成、ローカルの画像・動画モデル、クラウドの動画・音声モデル、そしてチームが自ら作るものなど、アプリ全体の機能を拡張します。このページでは、パッケージとは何か、どのパッケージがアプリに付属するのか、そしてデスクトップのPackagesウィンドウと gamedev pkg コマンドでそれらを管理する方法を説明します。

パッケージとは#

パッケージは、マニフェスト aigd-package.json と、任意でいくらかのJavaScriptを含むフォルダーです。仕組みはVS Code拡張機能と同じです。パッケージが表示するものはすべてマニフェストで宣言され、コードが実行される前に見え、コードは何かがそれを必要としたときにだけ起動します。

パッケージは次のものを提供できます:

• Tools行のセッションツール。多くの場合MCPサーバーに支えられ、エージェントが新しいツールを利用できるようになります。
• /blender や /kb などのスラッシュコマンド。デスクトップのチャットとCLIの両方で動作します。
• コマンドパレット用のコマンド、メニューとコンポーザーツールバーのボタン、ステータスバーの項目。
• パネル、サイドパネルのビュー、独自のウィンドウ、ファイルタイプ用のカスタムエディターやプレビュー。
• 設定、短いアプリ内チュートリアル、他のパッケージやClaudeプラグインへの依存関係。
• 純粋なデータ: ローカルの画像・動画モデルはコードを持たないパッケージで、ファイル、ダウンロードサイズ、ライセンス、対応するハードウェアを宣言します。

すべてのパッケージには publisher.name 形式のidがあります。ファーストパーティのパッケージはパブリッシャー aigd を使い、たとえば aigd.blender のようになります。

パッケージ、Claudeプラグイン、MCPサーバー、エンジン拡張機能#

アプリには4種類の拡張機能があります。どれも最終的にはエージェントが使えるツールになりますが、管理する場所が異なります:

Settingsで追加したMCPサーバーは、追加したときに開いていたプロジェクトに属し、他のプロジェクトには表示されません。新しいプラグインやMCPサーバーは、すでに開いているチャットには次のメッセージから適用されます。

アプリに付属するパッケージ#

初回起動時に、アプリはデフォルトのパッケージをユーザーレベルで自動的にインストールするので、すべてのプロジェクトで利用できます:

削除したデフォルトが再び追加されることはありません。パッケージをインストールしても、すべてのチャットで有効になるわけではありません。ツールはセッションごとにTools行でオンに切り替えます。ローカルの画像・動画モデルやクラウドモデルファミリーは個別のパッケージです。すべての一覧はパッケージカタログを参照してください。

Packagesウィンドウ#

ウィンドウ右下のステータスバーにあるパッケージアイコン（「Open Packages」）から開けます。上部にプロジェクトとそのレベルが表示され、以下のタブがあります:

• Installed: このプロジェクトで有効なパッケージと、そのステータス、バージョン、レベル。
• Browse: AI Game Devのパッケージレジストリを検索します。
• Claude plugins: パッケージがこのプロジェクトのために必要とするClaudeプラグイン。
• Models: ダウンロード可能なローカルの画像・動画モデル。プロジェクトに生成ランタイムがある場合に表示されます。

ヘッダーにはCheck for updatesとReloadがあり、後者はプロジェクトのパッケージを再起動します。パッケージを選択すると、その詳細、レベル、設定、エラーが表示されます。

パッケージをインストールする#

デスクトップアプリの場合#

1. Packagesウィンドウを開き、Browseを選択します。
2. たとえば hello で検索し、パッケージを選択します。
3. 追加ボタンの下でレベルを選択します: User、Project、Local（レベルを参照）。
4. Add to Project（またはAdd to User、Add to Local）をクリックします。

レジストリ外のパッケージを追加するには、追加ボックスに入力します。レジストリ ID（aigd.blender、任意で aigd.blender@^1.2 のようなバージョン範囲も可）、GitHub リンクまたは owner/repo、npm パッケージ（npm:<name> またはその npmjs.com リンク）、あるいはフォルダパスを受け付けます。

CLI で#

プロジェクトフォルダで gamedev pkg を実行するか（--cwd <path> を渡す）、インタラクティブ CLI で /packages を使います。既定のレベルは --project です。

gamedev pkg list                          # the packages in effect for this project
gamedev pkg list --user                   # the user level alone
gamedev pkg add aigd.blender --user       # from the registry, for every project
gamedev pkg add github:owner/repo         # from GitHub, for this project
gamedev pkg add npm:some-package --local  # from npm, this machine only

範囲を指定せずに追加されたレジストリパッケージは ^<installed version> として書き込まれるため、互換性のある更新を受け取ります。

レベル: user、project、local#

パッケージとその設定は 3 つのレベルで宣言されます。上位のレベルが下位のレベルを上書きします。local は project に勝ち、project は user に勝ちます。

各レベルにはその隣にロックファイル（packages-lock.json、packages-lock.local.json）もあり、正確なバージョンを固定するため、プロジェクトを共有するチームメイトは同じバイト列をインストールします。

チーム全体が必要とするパッケージには Project、個人的なツールには User、自分のコンピューターにインストールされたツールへのパスのようなマシン固有の選択には Local を使います。

1 つのプロジェクトでパッケージを除外する#

あるプロジェクトで user レベルのパッケージをオフにするには、それを選択してレベル行の Exclude を選ぶか、次のようにします:

gamedev pkg exclude aigd.blender            # off in this project (written to the project file)
gamedev pkg include aigd.blender            # undo

この場合プロジェクトファイルには "aigd.blender": false が保持され、他のプロジェクトには影響しません。

パッケージを更新する#

自動更新は既定でオンです。アプリは起動直後、4 時間ごと、および Check for updates をクリックしたときにチェックします。各レベルが宣言する範囲の中で、アプリと互換性のある最新バージョンをインストールし、実行ごとに 1 件の通知を表示します。たとえば「Updating 1 package… (1/1)」の後に「Updated 1 package」と表示されます。

• パッケージごとに、Packages ウィンドウの Auto-update スイッチ、または gamedev pkg auto-update off <id> で自動更新をオフにできます。この選択はコンピューターごとです。
• gamedev pkg update（すべて）または gamedev pkg update <id> で今すぐ更新します。
• ローカルフォルダからのパッケージ、およびタグに固定された GitHub ソースは自動更新されません。

新しいアプリを必要とするパッケージはその旨を表示します（「requires AI Game Dev >=X, you have Y」）。先にアプリを更新してください。

パッケージを削除する#

それを選択して Remove を選ぶか、次のようにします:

gamedev pkg remove <id>              # remove it from the project level
gamedev pkg remove <id> --user       # remove it from the user level

他のパッケージの依存関係としてのみインストールされたパッケージには Remove はなく、Exclude のみです。何も必要としなくなると自動的に消えます。

パッケージ設定#

パッケージを選択して Settings を開きます。各設定の横で、その設定を書き込むレベルを選びます。チップには現在の値がどこから来ているかが表示されます。設定には Browse… と空き容量チェックを備えたフォルダピッカーや、アプリから提供される選択肢もあります。

CLI では:

gamedev pkg settings aigd.blender                 # every key, its value and level
gamedev pkg settings <id> <key> <value> --local   # write a value at a level
gamedev pkg settings <id> <key> --unset --project # clear the value at a level

値は保存前に宣言された型と照合されます。拒否された値は何も変更せず、終了コード 1 で終了します。

依存関係#

パッケージは他のパッケージや Claude プラグインに依存できます。アプリがそれらをインストールし、プロジェクトごとに各パッケージのバージョンを 1 つだけ保持します。Packages ウィンドウでは依存関係が「installed for <id>」としてそのレベルとともに表示されます。パッケージが必要とする Claude プラグインはプロジェクトごとにアプリ管理のキャッシュへインストールされ、そのプロジェクトのセッションでのみ読み込まれ、あなた自身の Claude Code には決して読み込まれません。

安全性とエラー#

パッケージは VS Code 拡張機能と同様にユーザーの権限で実行されます。サンドボックスはありません。信頼できるソースからのみパッケージをインストールしてください。AI Game Dev レジストリのパッケージは、展開前に公開されたチェックサムと照合して検証されます。

パッケージが失敗すると、そのカードに警告数が表示され、Errors タブに詳細が一覧表示されます。サードパーティパッケージのエラーはどこにも送信されません。当社のレジストリにあるファーストパーティの aigd パッケージのエラーは、クラッシュレポートへの同意がある場合にのみ当社へ報告されます。インストール済みのパッケージはネットワーク接続なしで起動します。

次のステップ#

• パッケージカタログで利用可能なすべてのパッケージを確認できます。
• パッケージの作成で独自のパッケージを作成できます。
• ブログ記事 packages, Claude plugins and MCP serversでは、Packages ウィンドウとプロジェクトの MCP サーバーが実際に動作する様子を紹介しています。