GitHub Copilot CLI のプラグインの検索とインストール

コミュニティまたは組織によって作成されたプラグインをインストールして、 Copilot を拡張します。

この記事で

プラグインは、 Copilot CLIの機能を拡張するパッケージです。 CLI に登録したマーケットプレースからプラグインをインストールできます。

概要については、「GitHub Copilot 用のプラグイン」を参照してください。

メモ

ターミナルで copilot plugin [SUBCOMMAND] --help を入力すると、プラグインの使用に関するヘルプが表示されます。

プラグインを検索する

プラグインはマーケットプレースに集約されています。 Marketplace は、参照してインストールできるプラグインのレジストリです。 Copilot CLI には、既定で awesome-copilot Marketplace が含まれています。

登録されているマーケットプレースを一覧表示するには、次のように入力します。

Shell
copilot plugin marketplace list

対話型セッションで、次のように入力します。

Copilot prompt
/plugin marketplace list

登録済みマーケットプレースでプラグインを参照するには、次のように入力します。

Shell
copilot plugin marketplace browse MARKETPLACE-NAME

MARKETPLACE-NAME をマーケットプレース名に置き換えてください。

対話型セッションで、次のように入力します。

Copilot prompt
/plugin marketplace browse MARKETPLACE-NAME

プラグインをインストールする

登録済みマーケットプレースからプラグインをインストールするには、次のように入力します。

Shell
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

たとえば、database-data-managementからawesome-copilotをインストールするには、次のように入力します。

Shell
copilot plugin install database-data-management@awesome-copilot

対話型セッションで、次のように入力します。

Copilot prompt
/plugin install PLUGIN-NAME@MARKETPLACE-NAME

GitHub リポジトリ、Git URL、リポジトリ サブディレクトリ、またはローカル パスからプラグインをインストールすることもできます。 サポートされる形式については、install コマンド用プラグインの仕様を参照してください。

インストールされているプラグインを管理する

インストールされているプラグインを管理するには、次のコマンドを使用します。

Shell
copilot plugin list
copilot plugin update PLUGIN-NAME
copilot plugin uninstall PLUGIN-NAME
copilot plugin disable PLUGIN-NAME
copilot plugin enable PLUGIN-NAME

disable は、プラグインをアンインストールせずにオフにします。 uninstall はそれを削除します。 すべてのコマンドとオプションについては、GitHub Copilot CLI プラグイン リファレンス を参照してください。

マーケットプレースを追加する

GitHub リポジトリでホストされているマーケットプレースを登録するには、次のように入力します。

Shell
copilot plugin marketplace add OWNER/REPOSITORY

OWNER/REPOSITORYを、マーケットプレースをホストするリポジトリに置き換えます。 例えば次が挙げられます。

Shell
copilot plugin marketplace add anthropics/claude-code

対話型セッションで、次のように入力します。

Copilot prompt
/plugin marketplace add OWNER/REPOSITORY

また、ローカル ディレクトリまたは他の場所でホストされている Git リポジトリからマーケットプレース ソースを追加することもできます。 ローカル ソースには、Marketplace ディレクトリ パスを使用します。

Shell
copilot plugin marketplace add /PATH/TO/MARKETPLACE-DIRECTORY

他の場所でホストされている Git リポジトリの場合は、その Git URL を使用します。

Shell
copilot plugin marketplace add https://gitlab.com/OWNER/REPO.git

GitHubホスト型マーケットプレースの公開に関するガイダンスについては、GitHubでのプラグイン マーケットプレースの作成と共有 を参照してください。

マーケットプレースを削除する

マーケットプレースの登録を解除するには、次のように入力します。

Shell
copilot plugin marketplace remove MARKETPLACE-NAME

対話型セッションで、次のように入力します。

Copilot prompt
/plugin marketplace remove MARKETPLACE-NAME

マーケットプレースを追加するときは、ソースによって識別します。 削除するときは、Marketplace リストに表示されているマーケットプレース名を使用します。 マーケットプレースのプラグインがまだインストールされている場合、コマンドは失敗します。 これらのプラグインもアンインストールするには、--forceを追加します。

リポジトリの既定設定をオフにする

リポジトリの既定値は任意です。 リポジトリ設定で有効になっているプラグインを無効にするには、false の enabledPlugins に .github/copilot/settings.local.json エントリを追加します。

JSON
{
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": false
  }
}

識別子をプラグイン名とマーケットプレース名に置き換えます。 ファイルを保存し、新しいセッションを開始してください。 プラグインをオンに戻すには、エントリを true に設定してください。

このローカル設定ファイルはコミットしないでください。 エンタープライズ管理設定は、リポジトリの既定値とローカルオーバーライドよりも優先されます。 詳細については、「GitHub Copilot CLI の構成ディレクトリ」を参照してください。

詳細については、次を参照してください。