Plugin Creator

Create OpenCode plugins and know where to load them.

different-ai 50f7ee0 3 files · 1.4 KB Updated

File contents

Quick Usage (Already Configured)

Where plugins live

  • Project plugins: .opencode/plugins/*.js or .opencode/plugins/*.ts
  • Global plugins: ~/.config/opencode/plugins/*.js or .ts

Load from npm

Add npm plugin packages in opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-helicone-session", "opencode-wakatime"]
}

Minimal plugin template

export const MyPlugin = async ({ project, client, $, directory, worktree }) => {
  return {
    // Hook implementations go here
  }
}

Notes from OpenCode docs

  • Plugins are JS/TS modules exporting one or more plugin functions.
  • Local plugins are loaded directly from the plugin directory.
  • NPM plugins are installed via Bun at startup and cached in ~/.cache/opencode/node_modules/.
  • Load order: global config → project config → global plugins → project plugins.

Reference

Follow the official OpenCode plugin docs: https://opencode.ai/docs/plugins/ Use the docs as the escape hatch when unsure.

different-ai/the-factory/tree/main/.opencode/skills/plugin-creator commit 50f7ee0831

Frequently asked questions

npx skillmds@latest add different-ai/plugin-creator