writing-opencode-plugins

name	writing-opencode-plugins
description	OpenCode plugins, @opencode-ai/plugin, @opencode-ai/plugin/tui, plugin hooks, custom tools, TUI routes, slots, keymaps, and packaging. Use when creating, editing, reviewing, testing, or publishing server or TUI plugins for OpenCode.
metadata	{"internal":true}

Writing OpenCode Plugins

Use this skill to implement production-quality OpenCode plugins. Treat the repository's exported types and runtime as authoritative because plugin APIs are evolving and public docs may lag.

Start Here

1. Decide which runtime owns the feature.
2. Read the relevant public type before writing code.
3. Find one focused in-repository example using the same API.
4. Implement the smallest target-specific module.
5. Test loading, behavior, failure, and cleanup in the owning package.

Need	Plugin target	Import	Configuration
Hooks, tools, auth, providers, model parameters, shell environment	Server	@opencode-ai/plugin	opencode.json or auto-discovered .opencode/plugins/*.{ts,js}
Commands, keybindings, routes, dialogs, slots, themes, notifications	TUI	@opencode-ai/plugin/tui	Explicit tui.json plugin entry
Both	Two target-only entrypoints	Both imports in separate files	Package exports and