Creating OpenCode Plugins

Overview

OpenCode plugins are JavaScript/TypeScript modules that hook into 25+ events across the OpenCode AI assistant lifecycle. Plugins export an async function receiving context (project, client, $, directory, worktree) and return an event handler.

When to Use

Create an OpenCode plugin when:

• Intercepting file operations (prevent sharing .env files)
• Monitoring command execution (notifications, logging)
• Processing LSP diagnostics (custom error handling)
• Managing permissions (auto-approve trusted operations)
• Reacting to session lifecycle (cleanup, initialization)
• Extending tool capabilities (custom tool registration)
• Enhancing TUI interactions (custom prompts, toasts)