Bug: `deduplicatePlugins` silently removes plugins whose entry point is `dist/index.js`

[wowuliao11]

Description

deduplicatePlugins in the config module uses path.parse(new URL(plugin).pathname).name to extract a plugin "name" for deduplication. When a plugin's file:// URL resolves to dist/index.js (which is the standard convention for npm packages), the extracted name is just "index".

This means any two plugins whose main/entry point is dist/index.js are considered duplicates, and only the last one survives deduplication. This is a silent data loss — no warning or error is emitted.

Reproduction

Configure 3+ plugins in opencode.json where at least 2 resolve to dist/index.js:

{
  "plugin": [
    "@nick-vi/opencode-type-inject",
    "opencode-supermemory",
    "@tarquinen/opencode-dcp",
    "oh-my-openagent"
  ]
}

Install all plugins in ~/.config/opencode/node_modules/ so that Stage 1 resolution (import.meta.resolve / createRequire) succeeds for all of them.

Result: Only type-inject (unique entry: .opencode/plugin/type-inject.ts) and oh-my-openagent (last index entry) are loaded. opencode-supermemory and @tarquinen/opencode-dcp are silently dropped.

Expected: All 4 plugins load.

Root Cause

In the config reader (src/config), Stage 1 resolution converts bare specifiers to file:// URLs:

data3.plugin[i8] = import.meta.resolve(plugin, options4.path);
// e.g. "file:///.../@tarquinen/opencode-dcp/dist/index.js"

Then deduplicatePlugins extracts names:

function getPluginName(plugin) {
    if (plugin.startsWith("file://")) {
        return path.parse(new URL(plugin).pathname).name;
        // Returns "index" for any plugin with dist/index.js entry
    }
    // ...
}

Since most npm packages use dist/index.js as their entry point, this effectively limits users to one locally-installed plugin with a standard entry point.

Suggested Fix

For file:// URLs, extract the package name from the path instead of the filename:

function getPluginName(plugin) {
    if (plugin.startsWith("file://")) {
        const pathname = new URL(plugin).pathname;
        // Extract package name from node_modules path
        const nmIdx = pathname.lastIndexOf("/node_modules/");
        if (nmIdx !== -1) {
            const afterNm = pathname.substring(nmIdx + "/node_modules/".length);
            // Handle scoped packages (@scope/name)
            const parts = afterNm.split("/");
            return parts[0].startsWith("@") ? `${parts[0]}/${parts[1]}` : parts[0];
        }
        return path.parse(pathname).name; // fallback
    }
    // ...
}

Workaround

Don't install plugins with dist/index.js entry points into ~/.config/opencode/node_modules/. Let Stage 1 resolution fail so they remain as bare specifiers (which use the correct package name for deduplication) and get loaded via BunProc.install from ~/.cache/opencode/.

Environment

• opencode version: 1.3.3 (Homebrew, macOS ARM64)
• OS: macOS (Apple Silicon)
• Affected plugins: any plugin with main: "dist/index.js" or "./dist/index.js" in package.json

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• [Bug]: file:// plugin dedup silently drops plugins when multiple share the same filename (e.g. index.js) #14304: file:// plugin dedup silently drops plugins when multiple share the same filename (e.g. index.js)
• Bug: getPluginName returns 'index' for file:// resolved plugins, causing deduplicatePlugins to silently drop unrelated plugins #17716: getPluginName returns 'index' for file:// resolved plugins, causing deduplicatePlugins to silently drop unrelated plugins
• Bug: getPluginName incorrectly deduplicates plugins with same entry filename (index.js) #12285: getPluginName incorrectly deduplicates plugins with same entry filename (index.js)
• Plugin deduplication incorrectly removes plugins with index.js entry points #11159: Plugin deduplication incorrectly removes plugins with index.js entry points
• Bug: file:// plugins with same filename incorrectly deduplicated #8759: file:// plugins with same filename incorrectly deduplicated
• [Bug]: Only the last plugin loads in OpenCode 1.1.32 - Multiple plugins not supported #10115: Only the last plugin loads in OpenCode 1.1.32 - Multiple plugins not supported

These issues appear to describe the same root cause: deduplicatePlugins / getPluginName using the filename instead of the package name for file:// URLs, causing plugins with dist/index.js entry points to be silently dropped.

[wowuliao11]

Thanks for the detailed write-up! After searching the issue tracker, I found that this same bug has already been reported (and is actively tracked) in several earlier issues:

• Plugin deduplication incorrectly removes plugins with index.js entry points #11159 — earliest report (Jan 2026)
• Bug: getPluginName incorrectly deduplicates plugins with same entry filename (index.js) #12285 — similar root cause analysis (Feb 2026)
• [Bug]: file:// plugin dedup silently drops plugins when multiple share the same filename (e.g. index.js) #14304 — most closely matches this description (Feb 2026), already assigned to @rekram1-node

The fix has also been attempted via PR #17718 (closed without merge). Continued discussion and a fix are best tracked on those existing issues to keep the signal consolidated.

Closing this as a duplicate of #14304. Apologies for the noise!