Bug: file:// plugins with same filename incorrectly deduplicated

[coleleavitt]

Bug Description

Multiple file:// plugins with the same entry point filename (e.g., index.js) are incorrectly treated as duplicates during plugin loading, causing only the last one to load.

Steps to Reproduce

1. Create a config with multiple file:// plugins using standard entry points:

{
  "plugin": [
    "file:///path/to/plugin-a/dist/index.js",
    "file:///path/to/plugin-b/dist/index.js",
    "file:///path/to/plugin-c/dist/index.js"
  ]
}

2. Start OpenCode with debug logging:

OPENCODE_LOG_LEVEL=DEBUG opencode run "test" 2>&1 | grep "loading plugin"

3. Observe that only the last plugin loads

Expected Behavior

All three plugins should load since they have different paths.

Actual Behavior

Only plugin-c loads. The deduplication logic in getPluginName() extracts only the filename ("index") for all three plugins, marking them as duplicates.

Root Cause

In packages/opencode/src/config/config.ts, the getPluginName() function extracts only the filename for file:// URLs:

if (plugin.startsWith("file://")) {
  return path.parse(new URL(plugin).pathname).name  // Returns "index" for all
}

This was designed for npm package deduplication but doesn't account for file:// plugins where:

• Multiple plugins may use the same filename (standard practice: index.js)
• Plugins in different directories should not be considered duplicates
• Even plugins in the same directory with different filenames should be allowed

Impact

• Users cannot use multiple local plugins with standard entry point names
• No warning is shown when plugins are silently dropped
• Workaround requires renaming entry points to unique names (non-standard)

Environment

• OpenCode version: 1.1.23
• Node/Bun version: Bun 1.3.5
• OS: Linux

Related

This affects anyone using local plugin development with standard JavaScript conventions.

[github-actions]

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

• bug: multiple plugins registering auth for the same provider silently overwrite each other #6261: Multiple plugins registering auth for the same provider silently overwrite each other (similar deduplication/overwriting behavior)
• @opencode-ai/plugin: ESM imports missing .js extension breaks plugin loading #8006: @opencode-ai/plugin ESM imports missing .js extension breaks plugin loading (related to entry point handling)

Feel free to ignore if none of these address your specific case.