diff --git a/packages/tui/src/plugin/runtime-plugin-support.bun.ts b/packages/tui/src/plugin/runtime-plugin-support.bun.ts
index 2f0a59f4c2b..409be04a019 100644
--- a/packages/tui/src/plugin/runtime-plugin-support.bun.ts
+++ b/packages/tui/src/plugin/runtime-plugin-support.bun.ts
@@ -1,3 +1,8 @@
+import { Plugin, PluginContextProvider, usePlugin } from "@opencode-ai/plugin/tui"
 import { ensureRuntimePluginSupport } from "@opentui/solid/runtime-plugin-support/configure"
 
-ensureRuntimePluginSupport()
+ensureRuntimePluginSupport({
+  additional: {
+    "@opencode-ai/plugin/tui": { Plugin, PluginContextProvider, usePlugin },
+  },
+})
diff --git a/packages/www/src/docs/content/build/plugins/cli.mdx b/packages/www/src/docs/content/build/plugins/cli.mdx
index 58414b978ec..c2500a6aad2 100644
--- a/packages/www/src/docs/content/build/plugins/cli.mdx
+++ b/packages/www/src/docs/content/build/plugins/cli.mdx
@@ -15,6 +15,9 @@ export default Plugin.define({
 })
 ```
 
+Import `@opencode-ai/plugin/tui` directly. OpenCode resolves this import at runtime, so local CLI plugins do not need an
+absolute path to an OpenCode checkout.
+
 ## Context
 
 `setup` receives configuration, app metadata, the current location, the OpenCode client, cached data, theme tokens, the
diff --git a/packages/www/src/docs/content/cli/plugins.mdx b/packages/www/src/docs/content/cli/plugins.mdx
index 77268877c1f..c6ad7527e61 100644
--- a/packages/www/src/docs/content/cli/plugins.mdx
+++ b/packages/www/src/docs/content/cli/plugins.mdx
@@ -54,3 +54,6 @@ OpenCode also discovers JavaScript and TypeScript plugins from `plugins/tui` und
 <global-config>/plugins/tui/status.ts
 <project>/.opencode/plugins/tui/status.ts
 ```
+
+Discovered plugins can import `@opencode-ai/plugin/tui` directly; OpenCode resolves the package at runtime. See
+[Building CLI plugins](/build/plugins/cli) for examples.