plugin-installer

OpenCode プラグインインストーラー

コミュニティカタログから OpenCode プラグインを見つけ、評価し、インストールできるようユーザーを支援します。

1. 利用可能なプラグインを一覧表示する

カタログスクリプトを実行して、利用可能なプラグインを確認します。

python3 ~/.config/opencode/skill/plugin-installer/scripts/list_plugins.py

出力には name: description と、詳細ファイルへのパスが表示されます。

2. プラグインの詳細を読む

該当するプラグインについて、ファイル全体を読みます。

references/plugins/<filename>.md

各ファイルには以下が含まれています。

• インストール設定（コピーして貼り付けられる JSON）
• セットアップ手順
• 機能と注意事項
• ドキュメントへのリンク

3. 推奨してインストールする

ユーザーに以下を示します。

• プラグインの機能
• opencode.json に追加するインストール用スニペット
• セットアップ手順（OAuth、設定ファイルなど）

<question_tool>

まとめて質問する： 関連する質問が2つ以上ある場合は、question ツールを使用します。質問が1つの場合は、プレーンテキストで質問します。

構文： header は12文字以下、label は1～5語とし、デフォルトの選択肢には「(Recommended)」を付けます。

質問するタイミング：該当するプラグインが複数ある場合、またはプラグインのセットアップが複雑な場合。

</question_tool>

インストール形式

opencode.json の plugin 配列に追加します。

{
  "plugin": [
    "package-name@version"
  ]
}

設定ファイルの場所：

• グローバル：~/.config/opencode/opencode.json
• プロジェクト：.opencode/opencode.json

バージョンの固定

// Pin version (RECOMMENDED)
"plugin": ["[email protected]"]

// Auto-update on restart
"plugin": ["package@latest"]

// Locked to first install (never updates)
"plugin": ["package"]

更新が止まっている場合に強制更新するには：

rm -rf ~/.cache/opencode/node_modules ~/.cache/opencode/bun.lock

<documenting_new_plugins>

カタログへの新しいプラグインの追加

新しい OpenCode プラグインを（ウェブ検索、GitHub、npm、ユーザーからの言及などで）見つけた場合は、今後の参照用に必ずドキュメントを作成してください。

ステップ1：プラグイン情報を収集する

ドキュメントを作成する前に、以下を収集します。

情報	確認先
パッケージ名	npm レジストリ、GitHub リポジトリ名
説明	README、package.json の description
インストール構文	スコープ付き（@org/pkg）か、通常の形式（pkg）かを確認
バージョン戦略	@latest を推奨するか、バージョンを固定するか
セットアップ手順	OAuth フロー、設定ファイル、環境変数
プロバイダー／モデルの要件	特定のプロバイダーでのみ動作するか
既知の問題	GitHub の issue、互換性に関する注記

ステップ2：プラグインファイルを作成する

場所： ~/.config/opencode/skill/plugin-installer/references/plugins/<name>.md

命名規則： npm パッケージ名を使用し、スコープ付きパッケージの場合は / を - に置き換えます。

• opencode-foo → opencode-foo.md
• @org/opencode-bar → org-opencode-bar.md

ステップ3：このテンプレートを使用する

---
name: package-name-or-@scope/package-name
description: One-line description for catalog listing (max ~80 chars)
---
# Plugin Display Name

Brief description of what this plugin does and why someone would use it.

## Installation

\`\`\`jsonc
{
  "plugin": ["package-name@latest"]
}
\`\`\`

## Setup

### Prerequisites
- List any requirements (accounts, API keys, other tools)

### Configuration
Step-by-step setup instructions.

## Features
- Key feature 1
- Key feature 2

## Caveats
- Known limitations
- Compatibility notes

## Links
- [GitHub](https://github.com/...)
- [npm](https://www.npmjs.com/package/...)

ステップ4：カタログを確認する

作成後、一覧表示スクリプトを実行して、プラグインが表示されることを確認します。

python3 ~/.config/opencode/skill/plugin-installer/scripts/list_plugins.py

</documenting_new_plugins>

<frontmatter_requirements>

フィールド	必須	目的
name	はい	"plugin": [] で使用するパッケージ名と完全に一致させます
description	はい	カタログの一覧に表示する1行の説明です

重要： name は npm パッケージ名（スコープがある場合はスコープも含む）と完全に一致させる必要があります。ユーザーはこの値を opencode.json にコピーします。

</frontmatter_requirements>

新しいプラグインのドキュメントを作成する

npm で @cooldev/opencode-metrics を見つけたとします。次のファイルを作成します。

ファイル： ~/.config/opencode/skill/plugin-installer/references/plugins/cooldev-opencode-metrics.md

---
name: @cooldev/opencode-metrics
description: Track AI usage metrics and export to dashboards
---
# OpenCode Metrics

Export your OpenCode usage data to external dashboards...

## Installation

\`\`\`jsonc
{
  "plugin": ["@cooldev/opencode-metrics@latest"]
}
\`\`\`

...