OpenCode V2 plugin load fails: missing default export in @warp-dot-dev/opencode-warp 0.1.7

Open Beginner friendly
#27 0 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
devtools

Research direction

Start with the package entrypoint at dist/index.js and the source definition of the named WarpPlugin export. Compare its export shape with the OpenCode V2 requirement for a default definition with an id and effect or setup function. Reproduce using the provided global plugin configuration and verify that the plugin loads without the missing-default-export error.

Written by the indexing model from the issue text.

Description

Summary

@warp-dot-dev/opencode-warp fails to load in OpenCode V2 because the plugin module does not provide the required default export.

Environment

  • OpenCode: v2.0.1
  • Plugin: @warp-dot-dev/opencode-warp@0.1.7
  • OS: macOS

Config

Using global OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["@warp-dot-dev/opencode-warp@0.1.7"]
}

Repro

  1. Add @warp-dot-dev/opencode-warp@0.1.7 to OpenCode V2 config under plugins
  2. Start or restart the OpenCode service
  3. OpenCode attempts to load the plugin
  4. Plugin fails during load

Actual result

OpenCode server log shows:

failed to load plugin
target=@warp-dot-dev/opencode-warp@0.1.7
cause="Cause([Fail(PluginModule.LoadError: Plugin must export a default definition with an id and an effect or setup function. (cause: SchemaError(Missing key
  at [\"default\"])))])"

Relevant log lines from ~/.local/share/opencode/log/opencode.log:

timestamp=2026-09-14T17:51:30.627Z level=INFO run=068d1430 msg="loading plugin" id=@warp-dot-dev/opencode-warp@0.1.7 entrypoint=file:///Users/.../.cache/opencode/npm/@warp-dot-dev/opencode-warp@0.1.7/.../dist/index.js role=server

timestamp=2026-09-14T17:51:30.629Z level=WARN run=068d1430 message="failed to load plugin" target=@warp-dot-dev/opencode-warp@0.1.7 ref=err_c21a6db6 cause="Cause([Fail(PluginModule.LoadError: Plugin must export a default definition with an id and an effect or setup function. (cause: SchemaError(Missing key
  at [\"default\"])))])" role=server

Expected result

Plugin should load successfully in OpenCode V2.

Notes

The current published source appears to export a named WarpPlugin symbol rather than a default export, which may explain the failure.

If helpful, I can test a patched build that exports a V2-compatible default plugin definition.

Dominant language
TypeScript
Stars
30
Forks
16
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from warpdotdev/opencode-warp

All issues in warpdotdev/opencode-warp

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.