opencode-plugin-browser 1.0.0-alpha.1

package/README.md

@@ -0,0 +1,56 @@
+# opencode-plugin-manager
+
+An [OpenCode](https://opencode.ai) sidebar section listing **plugins** with
+installed/uninstalled status — placed below the built-in MCP section and the
+Skills list, mirroring the built-in sidebar widgets.
+
+## What it shows
+
+- **Installed plugins** from the plugin registry (same list
+  `opencode2 plugin list` shows; built-ins excluded) with their activation
+  state: `✓ active`, `✗ failed`, `○ inactive`.
+- **LOCAL group** mixes registered plugins (`✓ … installed`) with workspace
+  plugin projects discovered by scanning the workspace root for sibling
+  directories whose `package.json` depends on `@opencode-ai/plugin` (private
+  monorepo roots and shared libraries excluded) — those show dimmed with
+  `○ … uninstalled` and a `[+]` to register them, same status column as
+  everything else.
+- **Built-in plugins** are listed by default (group collapsed to keep the
+  sidebar short) and can be hidden/shown with **`/plugins-builtins`** — a view
+  toggle only, persisted; built-ins always run. They can't be disabled
+  individually: the runtime has no per-built-in disable mechanism — the only
+  switch is the all-or-nothing `OPENCODE_DISABLE_DEFAULT_PLUGINS` env var,
+  whose state the widget shows when the BUILT-IN group is visible. Per-built-in
+  disable requires upstream support in OpenCode's plugin host.
+- **Plugin descriptions** — the registry exposes no human metadata, so the
+  plugin ships its own catalog (`builtins.ts`): curated descriptions for
+  well-known built-ins plus per-category generation (`provider.*`, `tool.*`,
+  `config.*`, `websearch.*`). Click any row to inspect its details.
+
+Collapsed header shows `PLUGINS (installed/total)`; more than two entries
+collapse, click (or expand) to list them — same interaction as the built-in
+MCP/Skills sections.
+
+## Install
+
+```sh
+# in opencode.jsonc
+{ "plugins": ["./opencode-usage-quota-tracker", "./opencode-skill-lister", "./opencode-plugin-manager", "./opencode-model-recommender"] }
+```
+
+Order matters: plugins sharing the `sidebar.content` slot render in
+`plugins` array order — keep this entry after `opencode-skill-lister` (and
+before anything you want below it) so the section sits directly under
+**MCP** and **Skills**.
+
+## Data sources
+
+- Plugin registry: `client.plugin.list()` (activation state included)
+- Workspace scan: sibling directories of the current location, one
+  `package.json` read per candidate; result is cached through
+  [opencode-plugin-kit](../opencode-plugin-kit)'s `createCachedStore` so the
+  sidebar restores instantly after a TUI restart.
+
+## License
+
+GNU Affero General Public License v3.0 — see [LICENSE](LICENSE).

package/builtins.ts

@@ -0,0 +1,47 @@
+// Descriptions for built-in OpenCode plugins. The registry (/api/plugin)
+// exposes only id/source/state — no human metadata — so the plugin ships its
+// own catalog. Categories (opencode.<category>.<name>) get generated
+// descriptions; well-known plugins get curated overrides.
+
+const OVERRIDES: Record<string, string> = {
+  "opencode.agent": "Agent runtime: session agents, subagents, and agent state.",
+  "opencode.browser": "Desktop browser integration for automation and page capture.",
+  "opencode.command": "Command registry: slash commands and their execution wiring.",
+  "opencode.mcp.codemode.exclusion": "Excludes MCP tools from code-mode execution where unsafe.",
+  "opencode.models.dev": "models.dev catalog sync: model metadata and pricing.",
+  "opencode.plan": "Plan mode: read-only planning sessions before execution.",
+  "opencode.skill": "Skills runtime: discovers and exposes SKILL.md-based skills.",
+  "opencode.tools": "Tool namespace: registers the core tool set for sessions.",
+  "opencode.variant": "Model variant handling (provider-specific model settings).",
+  "opencode.warming": "Warms providers/connections at startup for faster first use.",
+  "opencode.wellknown": "Serves well-known endpoints for integrations and discovery.",
+  "opencode.vcs.git": "Git integration: status, diffs, branches, worktrees.",
+  "opencode.vcs.hg": "Mercurial integration: status, diffs, and branches.",
+  "opencode.prompt.openai": "Prompt-shaping adaptations for OpenAI models.",
+  "opencode.prompt.kimi": "Prompt-shaping adaptations for Kimi models.",
+  "opencode.prompt.arcee": "Prompt-shaping adaptations for Arcee models.",
+  "opencode.prompt.meta": "Prompt-shaping adaptations for Meta (Llama) models.",
+}
+
+const CATEGORIES: Record<string, (name: string) => string> = {
+  provider: (n) => `Provider integration for ${n} (auth, API, model wiring).`,
+  tool: (n) => `Core "${n}" tool implementation for agent sessions.`,
+  config: (n) => `Loads and applies ${n} configuration into the runtime.`,
+  websearch: (n) => `Web search backend (${n}) for the websearch tool.`,
+}
+
+/** Best-effort description for a built-in plugin id. */
+export function describeBuiltin(id: string): string {
+  const override = OVERRIDES[id]
+  if (override) return override
+  const parts = id.split(".")
+  // Expect "opencode.<category>.<name...>"
+  if (parts[0] === "opencode" && parts.length >= 3) {
+    const category = parts[1]
+    const name = parts.slice(2).join(" ")
+    const gen = CATEGORIES[category]
+    if (gen) return gen(name)
+    return `Built-in ${category} plugin: ${name}.`
+  }
+  return "Built-in plugin."
+}

package/index.ts

@@ -0,0 +1,15 @@
+// Server-side entrypoint. All behavior (the sidebar plugins list) lives in
+// the TUI entrypoint (tui.tsx), exposed via the "./tui" export. The server
+// role must not import JSX — OpenCode's server transpiler resolves JSX with
+// the default "react" runtime, which is not installed and fails the load.
+import { Plugin } from "@opencode-ai/plugin"
+
+// Hoisted into a named binding: a bare `export default <object expression>`
+// produces empty v8 coverage maps for this file.
+const plugin = Plugin.define({
+  id: "plugin-manager.server",
+  setup() {},
+})
+
+export { plugin }
+export default plugin

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "opencode-plugin-browser",
+  "version": "1.0.0-alpha.1",
+  "description": "Sidebar section listing OpenCode plugins with installed/uninstalled status, below MCPs and Skills.",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugins",
+    "sidebar"
+  ],
+  "license": "AGPL-3.0",
+  "author": "Ranjith Raj",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ranjithrajv/opencode-plugin-manager.git"
+  },
+  "files": [
+    "index.ts",
+    "tui.tsx",
+    "builtins.ts"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./tui": "./tui.tsx"
+  },
+  "scripts": {
+    "check": "vp check",
+    "check:fix": "vp check --fix",
+    "fmt": "vp fmt",
+    "lint": "vp lint",
+    "typecheck": "tsc --noEmit",
+    "test": "vp test",
+    "test:coverage": "vitest run --coverage.enabled"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "beta",
+    "opencode-plugin-kit": "^1.0.0-alpha.2"
+  },
+  "devDependencies": {
+    "@opentui/core": "^0.5.11",
+    "@opentui/solid": "^0.5.11",
+    "@types/node": "^26.5.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "happy-dom": "^20.14.0",
+    "js-tokens": "^10.0.0",
+    "solid-js": "1.9.15",
+    "typescript": "^7.0.2",
+    "vite": "^7.0.0",
+    "vite-plugin-solid": "^2.11.14",
+    "vite-plus": "^0.1.16",
+    "vitest": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@opentui/core": "^0.5.11",
+    "@opentui/solid": "^0.5.11",
+    "solid-js": "^1.9.15"
+  },
+  "packageManager": "npm@11.19.1"
+}