opencode-see-image 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# opencode-see-image
+
+Give non-vision opencode models the ability to **see images and screenshots** by routing them to a vision-capable model.
+
+When a user attaches a screenshot to a text-only model (e.g. GLM-5.2, DeepSeek, Kimi), opencode rejects it with an error. This plugin intercepts that flow: it registers a `see_image` tool that sends the image to a vision model (MiniMax M3 by default) and returns a textual description the primary model can reason about.
+
+## Install
+
+Add the plugin to your opencode config:
+
+```jsonc
+// ~/.config/opencode/opencode.jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-see-image"]
+}
+```
+
+Then **restart opencode**.
+
+That's it — the plugin self-contains both the tool and the triggering instructions (injected into the system prompt). No separate skill file needed.
+
+## Prerequisites
+
+You need a connected vision-capable provider. The defaults assume **opencode-go** with **MiniMax M3**:
+
+1. Run `/connect` in opencode
+2. Select **opencode-go**
+3. Paste your API key from [opencode.ai/auth](https://opencode.ai/auth)
+
+If you already have opencode-go connected, you're done.
+
+## How it works
+
+```
+user attaches screenshot
+        │
+        ▼
+opencode rejects it: 'this model does not support image input'
+        │  (the model only sees the filename, no pixels)
+        ▼
+plugin's system-prompt instructions tell the model to call see_image
+        │
+        ▼
+see_image tool:
+  1. locates the file (macOS screenshot temp dirs, ~/Desktop, ~/Downloads, cwd)
+  2. base64-encodes it
+  3. sends it to the vision model via the Anthropic Messages API
+  4. returns the textual description
+        │
+        ▼
+primary model answers using the description
+```
+
+## Configuration
+
+All settings are env-var overrides. Defaults work out-of-the-box for opencode-go + MiniMax M3.
+
+| Env var | Default | Description |
+|---|---|---|
+| `SEE_IMAGE_MODEL` | `minimax-m3` | Vision model ID to call |
+| `SEE_IMAGE_PROVIDER` | `opencode-go` | Provider key in opencode's `auth.json` |
+| `SEE_IMAGE_ENDPOINT` | `https://opencode.ai/zen/go/v1/messages` | Anthropic-Messages-compatible endpoint |
+| `SEE_IMAGE_API_KEY` | _(reads auth.json)_ | Bypass auth.json with an explicit key |
+| `SEE_IMAGE_API_VERSION` | `2023-06-01` | `anthropic-version` header value |
+| `SEE_IMAGE_USER_AGENT` | _(Chrome UA)_ | Override the User-Agent header |
+
+### Using a different vision model
+
+Any Anthropic-Messages-compatible endpoint works. For example, to use a direct MiniMax key:
+
+```bash
+export SEE_IMAGE_ENDPOINT="https://api.minimax.io/v1/messages"
+export SEE_IMAGE_MODEL="minimax-m3"
+export SEE_IMAGE_API_KEY="your-minimax-key"
+```
+
+To use a different opencode-go model (e.g. Kimi K2.7):
+
+```bash
+export SEE_IMAGE_MODEL="kimi-k2.7-code"
+```
+
+### Verified vision-capable models on opencode-go
+
+| Model | Speed | Notes |
+|---|---|---|
+| `minimax-m3` | ~3s | Default. Fast, clean text output. |
+| `kimi-k2.7-code` | ~7s | Clean output, accurate. |
+| `kimi-k2.6` | ~20s | Accurate but slow. |
+| `qwen3.7-plus` | ~20s | Emits thinking blocks (handled). |
+
+## File search locations
+
+When opencode rejects an image attachment, the model only receives a bare filename. `see_image` searches these locations in order:
+
+1. `$TMPDIR/TemporaryItems/NSIRD_screencaptureui_*/` — where macOS stashes dragged screenshots
+2. `$TMPDIR/TemporaryItems/`
+3. `~/Desktop` — default screenshot save location
+4. `~/Downloads`
+5. Current working directory
+
+Pass an absolute `filePath` to skip the search.
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,73 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "opencode-see-image",
+      "dependencies": {
+        "@opencode-ai/plugin": "^1.15.0",
+      },
+    },
+  },
+  "packages": {
+    "@msgpackr-extract/msgpackr-extract-darwin-arm64": ["@msgpackr-extract/msgpackr-extract-darwin-arm64@3.0.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-LCkGo6JDfaBhgST7UpPWgNgLINpcpabaHfyz5OBx75nUYxBsaEPxjnyNjWpeb/xBup/682QnBfRBy2/LvPutZQ=="],
+
+    "@msgpackr-extract/msgpackr-extract-darwin-x64": ["@msgpackr-extract/msgpackr-extract-darwin-x64@3.0.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-zExlW9zUJKZH/tOtVMttwjKa4Xm/3KcNjnE3dPN92uCktwavMxpgCA3MoJK/DOnTWsQgo224OaST27/mPNAf+w=="],
+
+    "@msgpackr-extract/msgpackr-extract-linux-arm": ["@msgpackr-extract/msgpackr-extract-linux-arm@3.0.4", "", { "os": "linux", "cpu": "arm" }, "sha512-Tg3yX65f5GbtXLkrYEHE5oibZG9epyYWas7FogTTEJeDEF9JlXJzKgXaNhT3UXlTOeA+AfZpYZYZ0uPj7Cfquw=="],
+
+    "@msgpackr-extract/msgpackr-extract-linux-arm64": ["@msgpackr-extract/msgpackr-extract-linux-arm64@3.0.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-dgX0P/9wGPJeHFBG+ZmhgE6bmtMt7NP5CRBGyyktpopdk/mW4POnrpQsSLtKI1dwpc+pPLuXHDh6vvskyQE/sw=="],
+
+    "@msgpackr-extract/msgpackr-extract-linux-x64": ["@msgpackr-extract/msgpackr-extract-linux-x64@3.0.4", "", { "os": "linux", "cpu": "x64" }, "sha512-8TNXMEjJc3QEy7R/x1INhgiU+XakDAFUzBhaz7+Rbrs8NH5UQeHQxxmzsSBJGyV6I1jW79undiQm8tOI+D+8FQ=="],
+
+    "@msgpackr-extract/msgpackr-extract-win32-x64": ["@msgpackr-extract/msgpackr-extract-win32-x64@3.0.4", "", { "os": "win32", "cpu": "x64" }, "sha512-CmCXPQrkbwExx3j946/PtHWHbYJiCRBRDl4BlkRQcJB/YOwQxJRTpoo7aTsortjgoJ1x7opzTSxn7C+ASSLVjQ=="],
+
+    "@opencode-ai/plugin": ["@opencode-ai/plugin@1.17.8", "", { "dependencies": { "@opencode-ai/sdk": "1.17.8", "effect": "4.0.0-beta.74", "zod": "4.1.8" }, "peerDependencies": { "@opentui/core": ">=0.3.4", "@opentui/keymap": ">=0.3.4", "@opentui/solid": ">=0.3.4" }, "optionalPeers": ["@opentui/core", "@opentui/keymap", "@opentui/solid"] }, "sha512-pkmnYQz5d+xf0h6fAjgplSSJKLqgYKOXr+x6y40GRPdW+/IfndFkMGq7CDsG2SieGD84qv4zYDMyolGo06IMpw=="],
+
+    "@opencode-ai/sdk": ["@opencode-ai/sdk@1.17.8", "", { "dependencies": { "cross-spawn": "7.0.6" } }, "sha512-6MKmsj2ujZyL44jy+12dpwWYDYKPS9fUr+0wVQxaIlPYQ/eAt8T8T3QrybplJ5ZtHfZUX+esXZ02x2UYYm7oEw=="],
+
+    "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
+
+    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
+
+    "detect-libc": ["detect-libc@2.1.2", "", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="],
+
+    "effect": ["effect@4.0.0-beta.74", "", { "dependencies": { "@standard-schema/spec": "^1.1.0", "fast-check": "^4.8.0", "find-my-way-ts": "^0.1.6", "ini": "^7.0.0", "kubernetes-types": "^1.30.0", "msgpackr": "^2.0.1", "multipasta": "^0.2.7", "toml": "^4.1.1", "uuid": "^14.0.0", "yaml": "^2.9.0" } }, "sha512-Yx+Kh12U+i2FmjwEfKs+ePFmpMd43RPD1oGqc/VraSS9bYzvF0Ff3PojwEFEVEewp8xc92Uxu28gTspU4qyvHA=="],
+
+    "fast-check": ["fast-check@4.8.0", "", { "dependencies": { "pure-rand": "^8.0.0" } }, "sha512-GOJ158CUMnN6cSahsv4+ExARvIDuzzinFjkp0E9WtiBa5zcVeLozVkWaE4IzFcc+Y48Wp1EDlUZsXRyAztQcSg=="],
+
+    "find-my-way-ts": ["find-my-way-ts@0.1.6", "", {}, "sha512-a85L9ZoXtNAey3Y6Z+eBWW658kO/MwR7zIafkIUPUMf3isZG0NCs2pjW2wtjxAKuJPxMAsHUIP4ZPGv0o5gyTA=="],
+
+    "ini": ["ini@7.0.0", "", {}, "sha512-ifK0CgjALofS5bkrcTy4RaQ9Vx2Knf/eLeIO+NaswQEpH1UblrtTSCIvN71qQDMq0PeQ/SSPojvEJp9vvvfr+w=="],
+
+    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
+
+    "kubernetes-types": ["kubernetes-types@1.30.0", "", {}, "sha512-Dew1okvhM/SQcIa2rcgujNndZwU8VnSapDgdxlYoB84ZlpAD43U6KLAFqYo17ykSFGHNPrg0qry0bP+GJd9v7Q=="],
+
+    "msgpackr": ["msgpackr@2.0.4", "", { "optionalDependencies": { "msgpackr-extract": "^3.0.4" } }, "sha512-o1C5KRmuRt+apqMr1HuGSqWStZoRBUpEsCsl15uM9VdAF1qHLtvMOU2En747EnTyEl6c4pzPewRMFF31s1CNbA=="],
+
+    "msgpackr-extract": ["msgpackr-extract@3.0.4", "", { "dependencies": { "node-gyp-build-optional-packages": "5.2.2" }, "optionalDependencies": { "@msgpackr-extract/msgpackr-extract-darwin-arm64": "3.0.4", "@msgpackr-extract/msgpackr-extract-darwin-x64": "3.0.4", "@msgpackr-extract/msgpackr-extract-linux-arm": "3.0.4", "@msgpackr-extract/msgpackr-extract-linux-arm64": "3.0.4", "@msgpackr-extract/msgpackr-extract-linux-x64": "3.0.4", "@msgpackr-extract/msgpackr-extract-win32-x64": "3.0.4" }, "bin": { "download-msgpackr-prebuilds": "bin/download-prebuilds.js" } }, "sha512-4kmO/MdyUIkLIvTPr8VHLil4AtoKIoniWPIEk5+CDy0xnWC84azhSFmuJ7PxZdsYtiP5kEeQsORAVIeMgxT+Hw=="],
+
+    "multipasta": ["multipasta@0.2.7", "", {}, "sha512-KPA58d68KgGil15oDqXjkUBEBYc00XvbPj5/X+dyzeo/lWm9Nc25pQRlf1D+gv4OpK7NM0J1odrbu9JNNGvynA=="],
+
+    "node-gyp-build-optional-packages": ["node-gyp-build-optional-packages@5.2.2", "", { "dependencies": { "detect-libc": "^2.0.1" }, "bin": { "node-gyp-build-optional-packages": "bin.js", "node-gyp-build-optional-packages-optional": "optional.js", "node-gyp-build-optional-packages-test": "build-test.js" } }, "sha512-s+w+rBWnpTMwSFbaE0UXsRlg7hU4FjekKU4eyAih5T8nJuNZT1nNsskXpxmeqSK9UzkBl6UgRlnKc8hz8IEqOw=="],
+
+    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
+
+    "pure-rand": ["pure-rand@8.4.0", "", {}, "sha512-IoM8YF/jY0hiugFo/wOWqfmarlE6J0wc6fDK1PhftMk7MGhVZl88sZimmqBBFomLOCSmcCCpsfj7wXASCpvK9A=="],
+
+    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
+
+    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
+
+    "toml": ["toml@4.1.1", "", {}, "sha512-EBJnVBr3dTXdA89WVFoAIPUqkBjxPMwRqsfuo1r240tKFHXv3zgca4+NJib/h6TyvGF7vOawz0jGuryJCdNHrw=="],
+
+    "uuid": ["uuid@14.0.0", "", { "bin": { "uuid": "dist-node/bin/uuid" } }, "sha512-Qo+uWgilfSmAhXCMav1uYFynlQO7fMFiMVZsQqZRMIXp0O7rR7qjkj+cPvBHLgBqi960QCoo/PH2/6ZtVqKvrg=="],
+
+    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
+
+    "yaml": ["yaml@2.9.0", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA=="],
+
+    "zod": ["zod@4.1.8", "", {}, "sha512-5R1P+WwQqmmMIEACyzSvo4JXHY5WiAFHRMg+zBZKgKS+Q1viRa0C1hmUKtHltoIFKtIdki3pRxkmpP74jnNYHQ=="],
+  }
+}

package/index.ts

@@ -0,0 +1,240 @@
+import { tool } from "@opencode-ai/plugin"
+import path from "path"
+import os from "os"
+import fs from "fs"
+import type { Plugin } from "@opencode-ai/plugin"
+
+// ─── Configuration (env-overridable) ────────────────────────────────────────
+// Defaults target opencode-go's MiniMax M3. Users on other providers can
+// override via environment variables without editing this file.
+
+const ENDPOINT =
+  process.env.SEE_IMAGE_ENDPOINT ||
+  "https://opencode.ai/zen/go/v1/messages"
+const MODEL = process.env.SEE_IMAGE_MODEL || "minimax-m3"
+const PROVIDER_ID = process.env.SEE_IMAGE_PROVIDER || "opencode-go"
+const API_VERSION = process.env.SEE_IMAGE_API_VERSION || "2023-06-01"
+const USER_AGENT =
+  process.env.SEE_IMAGE_USER_AGENT ||
+  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36"
+
+const EXT_MEDIA: Record<string, string> = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  bmp: "image/bmp",
+}
+
+// ─── Auth ───────────────────────────────────────────────────────────────────
+function readApiKey(): string {
+  // 1. Explicit env var wins.
+  if (process.env.SEE_IMAGE_API_KEY) return process.env.SEE_IMAGE_API_KEY
+
+  // 2. Read from opencode's auth store (~/.local/share/opencode/auth.json).
+  const authPath = path.join(os.homedir(), ".local/share/opencode/auth.json")
+  try {
+    const auth = JSON.parse(fs.readFileSync(authPath, "utf8"))
+    const entry = auth[PROVIDER_ID]
+    if (entry && (entry.key || entry.access)) {
+      return entry.key || entry.access
+    }
+  } catch {
+    // fall through to error
+  }
+
+  throw new Error(
+    `see_image: no API key. Either run /connect for "${PROVIDER_ID}" in opencode, ` +
+      `or set SEE_IMAGE_API_KEY, or set SEE_IMAGE_PROVIDER to a connected provider ID. ` +
+      `(Looked in ${authPath} for key "${PROVIDER_ID}".)`,
+  )
+}
+
+// ─── File resolution ────────────────────────────────────────────────────────
+// When opencode rejects an image attachment, the model only sees a bare
+// filename (no path). This resolves bare filenames by searching the places
+// macOS / opencode tend to stash screenshots.
+function resolveFilePath(name: string, cwd: string): string {
+  if (path.isAbsolute(name) && fs.existsSync(name)) return name
+
+  const resolved = path.resolve(cwd, name)
+  if (fs.existsSync(resolved)) return resolved
+
+  const tmpdir = process.env.TMPDIR || "/tmp"
+  const searchDirs: string[] = []
+
+  // macOS screenshot tool temp dirs (NSIRD_screencaptureui_<rand>) — this is
+  // where dragged screenshots actually land, not ~/Desktop.
+  const tempItems = path.join(tmpdir, "TemporaryItems")
+  if (fs.existsSync(tempItems)) {
+    try {
+      for (const sub of fs.readdirSync(tempItems, { withFileTypes: true })) {
+        if (sub.isDirectory() && sub.name.startsWith("NSIRD_screencaptureui")) {
+          searchDirs.push(path.join(tempItems, sub.name))
+        }
+      }
+    } catch {}
+  }
+  searchDirs.push(tempItems)
+  searchDirs.push(path.join(os.homedir(), "Desktop"))
+  searchDirs.push(path.join(os.homedir(), "Downloads"))
+  searchDirs.push(cwd)
+
+  for (const dir of searchDirs) {
+    if (!dir) continue
+    try {
+      const full = path.join(dir, name)
+      if (fs.existsSync(full)) return full
+    } catch {}
+  }
+
+  // Shallow recursive search in the top-level search dirs.
+  for (const dir of searchDirs) {
+    if (!dir || !fs.existsSync(dir)) continue
+    try {
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === name) return path.join(dir, name)
+      }
+    } catch {}
+  }
+
+  const searched = searchDirs.filter(Boolean).join(", ")
+  throw new Error(
+    `see_image: could not find "${name}". Searched: ${searched}. ` +
+      `Pass an absolute filePath instead.`,
+  )
+}
+
+// ─── Tool definition ────────────────────────────────────────────────────────
+const seeImageTool = tool({
+  description:
+    'See an image/screenshot that the current model cannot view. Use when the user attaches an image and you get a "this model does not support image input" / "Cannot read" error, or when a screenshot/image is referenced ("see this", "can you see", .png/.jpg). Routes the image to a vision-capable model and returns a detailed textual description you can reason about as if you saw it. Pass filePath as an absolute path OR a bare filename (auto-located in macOS screenshot temp dirs, ~/Desktop, ~/Downloads, cwd).',
+  args: {
+    filePath: tool.schema
+      .string()
+      .describe(
+        'Path to the image. Absolute path, or a bare filename like "Screenshot 2026-06-18 at 17.32.24.png" to auto-locate.',
+      ),
+    question: tool.schema
+      .string()
+      .optional()
+      .describe(
+        "Optional specific question about the image. Defaults to a general detailed description.",
+      ),
+  },
+  async execute(args, context) {
+    const fullPath = resolveFilePath(args.filePath, context.directory)
+    const ext = path.extname(fullPath).slice(1).toLowerCase()
+    const mediaType = EXT_MEDIA[ext] || "image/png"
+
+    const buf = fs.readFileSync(fullPath)
+    const b64 = Buffer.from(buf).toString("base64")
+
+    const prompt =
+      args.question && args.question.trim().length > 0
+        ? args.question
+        : "Describe this image in detail. If it is a screenshot, describe the UI, text content, and layout precisely. This description will be used by another model to answer the user, so be thorough and accurate."
+
+    const body = {
+      model: MODEL,
+      max_tokens: 2048,
+      messages: [
+        {
+          role: "user",
+          content: [
+            {
+              type: "image",
+              source: { type: "base64", media_type: mediaType, data: b64 },
+            },
+            { type: "text", text: prompt },
+          ],
+        },
+      ],
+    }
+
+    const key = readApiKey()
+    const res = await fetch(ENDPOINT, {
+      method: "POST",
+      headers: {
+        "x-api-key": key,
+        "anthropic-version": API_VERSION,
+        "content-type": "application/json",
+        "user-agent": USER_AGENT,
+      },
+      body: JSON.stringify(body),
+    })
+
+    if (!res.ok) {
+      const errText = await res.text()
+      throw new Error(
+        `see_image: vision call to "${MODEL}" failed: HTTP ${res.status} — ${errText.slice(0, 300)}`,
+      )
+    }
+
+    const data: any = await res.json()
+    // Join all text blocks, skipping thinking/signature blocks (some models
+    // like qwen/minimax-m2.7 emit reasoning before the answer).
+    const text = data?.content
+      ?.map((c: any) => c.text)
+      .filter((t: any) => typeof t === "string" && t.length > 0)
+      .join("\n")
+      .trim()
+
+    if (!text) {
+      throw new Error(
+        `see_image: model "${MODEL}" returned no text. Response: ${JSON.stringify(data).slice(0, 300)}`,
+      )
+    }
+
+    context.metadata({
+      title: `see_image: ${path.basename(fullPath)}`,
+      metadata: { model: MODEL, provider: PROVIDER_ID, file: fullPath },
+    })
+
+    return text
+  },
+})
+
+// ─── System prompt injection (the "skill") ──────────────────────────────────
+// Injected via experimental.chat.system.transform so the triggering logic
+// ships with the plugin — no separate SKILL.md install needed.
+const SYSTEM_INSTRUCTIONS = `# See Image (vision bridge) — opencode-see-image plugin
+
+You have access to a \`see_image\` tool. The current model may not support image input directly. When a user attaches a screenshot or image, opencode rejects it and you only receive an error string containing the **filename** — no path, no pixels. Use \`see_image\` to actually view it.
+
+## When to use \`see_image\`
+
+Use ONLY when one of these is true:
+1. You receive an error like: \`Cannot read "Screenshot ....png" (this model does not support image input)\`
+2. The user references an image/screenshot they expect you to see ("see this", "look at this", "can you see this", ".png"/".jpg")
+3. The user pastes an image path they want you to inspect
+
+Do NOT use \`see_image\` for reading text files — use the \`read\` tool for those.
+
+## How to use it
+
+1. **Extract the filename** from the error string (the quoted name), or use the path the user gave.
+2. **Call \`see_image\`** with \`filePath\` set to the bare filename (it auto-locates) or an absolute path. Pass an optional \`question\` if the user asked something specific.
+3. **Answer using the returned description** as if you saw the image. Be natural — don't mention that you used another model unless asked.
+
+## Important
+
+- Never guess or confabulate image contents from the filename or surrounding text. If you have not called \`see_image\`, you have NOT seen the image.
+- If the tool cannot find the file, tell the user the filename and ask for a full path or to drag the file into the project directory.
+- To inspect a specific detail, pass a targeted \`question\` (e.g. "What error is shown in the terminal?").`
+
+// ─── Plugin export ──────────────────────────────────────────────────────────
+const SeeImagePlugin: Plugin = async (ctx) => {
+  return {
+    tool: {
+      see_image: seeImageTool,
+    },
+    "experimental.chat.system.transform": async (_input, output) => {
+      output.system.push(SYSTEM_INSTRUCTIONS)
+    },
+  }
+}
+
+export default SeeImagePlugin
+export { SeeImagePlugin }

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "opencode-see-image",
+  "version": "0.1.0",
+  "description": "Give non-vision opencode models the ability to see images/screenshots by routing them to a vision-capable model (MiniMax M3 via opencode-go by default).",
+  "type": "module",
+  "main": "index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "scripts": {
+    "build": "bun build index.ts --target=bun --outdir dist",
+    "typecheck": "bun build index.ts --target=bun --outdir /tmp/see-image-check"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "vision",
+    "image",
+    "screenshot",
+    "minimax",
+    "glm"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.15.0"
+  }
+}