opencode-plugin-updater

Auto-update plugin for OpenCode.

Reads config/plugins.json, clones/pulls each plugin repo, runs configured build steps, and copies the output to the plugin directory on every OpenCode startup.

Features

• Automatic updates on startup — pulls latest code and rebuilds changed plugins in the background
• Manual mode — disable auto-update per plugin; update on demand via the plugin_update tool
• <creator>/<repo> directory layout — repos are stored under repos/<github-user>/<repo-name>, preventing name collisions
• Initial clone for manual plugins — even plugins with autoUpdate: false are cloned on first run so they are available immediately
• Centralized config — reads/writes config/plugins.json (auto-migrates from the legacy root location)
• Centralized logs — writes to logs/plugin-updater.log with automatic log rotation (keeps last 100 lines)
• Dual-exec guard — prevents running twice when OpenCode loads the plugin file more than once

Installation

Option A — npm (recommended)

Add the package to your ~/.config/opencode/opencode.json:

{
  "plugins": ["opencode-plugin-updater@latest"]
}

Restart OpenCode. The plugin is loaded directly from npm — no cloning or building required.

Option B — Manual bootstrap

1. Clone the repo:

mkdir -p ~/.config/opencode/repos/intisy/opencode-plugin-updater
git clone https://github.com/intisy/opencode-plugin-updater.git ~/.config/opencode/repos/intisy/opencode-plugin-updater
cp ~/.config/opencode/repos/intisy/opencode-plugin-updater/plugin-updater.js ~/.config/opencode/plugins/plugin-updater.js

2. Register the plugin in ~/.config/opencode/opencode.json:

{
  "plugins": {
    "plugin-updater": "./plugins/plugin-updater.js"
  }
}

Restart OpenCode. The plugin will keep itself (and all other plugins) up to date automatically from then on.

plugins.json Format

Create ~/.config/opencode/config/plugins.json with an array of plugin entries:

[
  {
    "name": "my-plugin",
    "url": "https://github.com/user/my-plugin.git",
    "install": ["bun", "install"],
    "build": ["bun", "run", "build"],
    "bundle": null,
    "output": "dist/plugin.js",
    "pluginFile": "my-plugin.js",
    "autoUpdate": true
  }
]

Field	Type	Description
name	string	Plugin identifier (used as repo folder name)
branch	string | null	Git branch to clone/pull (defaults to default branch)
url	string	Git clone URL
install	string[] | null	Install command (e.g. ["bun", "install"])
build	string[] | null	Build command (e.g. ["bun", "run", "build"])
bundle	string[] | null	Bundle command (optional second build step)
output	string	Path to the built plugin file inside the repo
pluginFile	string	Filename to use in the plugins/ directory
autoUpdate	boolean	Whether to auto-update on startup

Tools

Tool	Description
plugin_list	List all managed plugins with status, commit, and update availability
plugin_update	Pull, rebuild, and deploy a single plugin (or all)
plugin_auto_update	Toggle auto-update for a specific plugin

License

MIT