fix: NVM based OpenCode installs not working

Author: AshotN

src/main/kotlin/com/ashotn/opencode/relay/OpenCodeChecker.kt

@@ -43,10 +43,17 @@ object OpenCodeChecker {
                     add("/usr/local/bin/opencode")    // Homebrew (Intel Mac)
                     add("/opt/homebrew/bin/opencode") // Homebrew (Apple Silicon)
                     home?.let {
+                        addAll(nvmInstallLocations("$it/.nvm"))
                         add("$it/.local/bin/opencode")
                         add("$it/.bun/bin/opencode")
                         add("$it/.npm-global/bin/opencode")
                     }
+                    System.getenv("NVM_BIN")?.takeIf { it.isNotBlank() }?.let {
+                        add(File(it, "opencode").path)
+                    }
+                    System.getenv("NVM_DIR")?.takeIf { it.isNotBlank() }?.let {
+                        addAll(nvmInstallLocations(it))
+                    }
                 }
             }
 
@@ -55,11 +62,18 @@ object OpenCodeChecker {
                 buildList {
                     add("/usr/bin/opencode")
                     home?.let {
+                        addAll(nvmInstallLocations("$it/.nvm"))
                         add("$it/.opencode/bin/opencode")
                         add("$it/.local/bin/opencode")
                         add("$it/.bun/bin/opencode")
                         add("$it/.npm-global/bin/opencode")
                     }
+                    System.getenv("NVM_BIN")?.takeIf { it.isNotBlank() }?.let {
+                        add(File(it, "opencode").path)
+                    }
+                    System.getenv("NVM_DIR")?.takeIf { it.isNotBlank() }?.let {
+                        addAll(nvmInstallLocations(it))
+                    }
                 }
             }
 
@@ -97,6 +111,22 @@ object OpenCodeChecker {
         }
     }
 
+    // NVM keeps packages under each installed Node version, so scan versions/node/*/bin/opencode.
+    private fun nvmInstallLocations(rootPath: String): List<String> {
+        val root = File(rootPath)
+        val versionsRoot = File(root, "versions/node")
+        if (!versionsRoot.isDirectory) return emptyList()
+
+        return versionsRoot.listFiles()
+            .orEmpty()
+            .asSequence()
+            .filter { it.isDirectory }
+            .sortedByDescending { it.name }
+            .map { versionDir -> File(versionDir, "bin/opencode").path }
+            .distinct()
+            .toList()
+    }
+
     private fun autoResolve(): OpenCodeInfo? {
         val executableNames =
             if (SystemInfo.isWindows) {
@@ -212,6 +242,7 @@ object OpenCodeChecker {
         return try {
             val process = ProcessBuilder(path, arg)
                 .redirectErrorStream(true)
+                .apply { OpenCodeProcessEnvironment.configure(this, path) }
                 .start()
 
             var output = ""

src/main/kotlin/com/ashotn/opencode/relay/OpenCodeProcessEnvironment.kt

@@ -0,0 +1,58 @@
+package com.ashotn.opencode.relay
+
+import com.intellij.openapi.util.SystemInfo
+import java.io.File
+
+internal object OpenCodeProcessEnvironment {
+
+    fun configure(processBuilder: ProcessBuilder, executablePath: String) {
+        nvmBinDirectory(executablePath)?.let { binDir ->
+            prependPath(processBuilder.environment(), binDir)
+        }
+    }
+
+    fun terminalCommand(command: List<String>): List<String> {
+        if (command.isEmpty()) return command
+
+        val executablePath = command.first()
+        val nvmBinDirectory = nvmBinDirectory(executablePath) ?: return command
+        if (SystemInfo.isWindows) return command
+
+        return listOf(
+            "/usr/bin/env",
+            "PATH=${pathWithPrependedDirectory(System.getenv("PATH"), nvmBinDirectory)}",
+        ) + command
+    }
+
+    private fun nvmBinDirectory(executablePath: String): String? {
+        val executable = File(executablePath)
+        val parent = executable.parentFile ?: return null
+        val normalizedParent = parent.invariantSeparatorsPath
+        val normalizedExecutable = executable.invariantSeparatorsPath
+
+        return if (
+            normalizedParent.endsWith("/bin") &&
+            normalizedExecutable.contains("/.nvm/versions/node/")
+        ) {
+            parent.absolutePath
+        } else {
+            null
+        }
+    }
+
+    private fun prependPath(environment: MutableMap<String, String>, directory: String) {
+        val pathKey = environment.keys.firstOrNull { it.equals("PATH", ignoreCase = true) } ?: "PATH"
+        environment[pathKey] = pathWithPrependedDirectory(environment[pathKey], directory)
+    }
+
+    private fun pathWithPrependedDirectory(currentPath: String?, directory: String): String {
+        val pathEntries = currentPath.orEmpty().split(File.pathSeparator).filter { it.isNotBlank() }
+        if (pathEntries.any { it == directory }) return currentPath.orEmpty()
+
+        return if (currentPath.isNullOrBlank()) {
+            directory
+        } else {
+            directory + File.pathSeparator + currentPath
+        }
+    }
+}

src/main/kotlin/com/ashotn/opencode/relay/ServerManager.kt

@@ -305,6 +305,7 @@ class ServerManager(
                 val process = ProcessBuilder(command)
                     .inheritIO()
                     .apply {
+                        OpenCodeProcessEnvironment.configure(this, executablePath)
                         val basePath = project.basePath
                         if (basePath != null) directory(File(basePath))
                     }

src/main/kotlin/com/ashotn/opencode/relay/terminal/ClassicTuiPanel.kt

@@ -1,6 +1,7 @@
 package com.ashotn.opencode.relay.terminal
 
 import com.ashotn.opencode.relay.OpenCodePlugin
+import com.ashotn.opencode.relay.OpenCodeProcessEnvironment
 import com.ashotn.opencode.relay.settings.OpenCodeSettings
 import com.ashotn.opencode.relay.util.serverUrl
 import com.intellij.openapi.Disposable
@@ -64,10 +65,12 @@ class ClassicTuiPanel(
             }
 
             val workingDir = project.basePath ?: System.getProperty("user.home")
-            val command = listOf(
-                executablePath,
-                "attach",
-                serverUrl(OpenCodeSettings.getInstance(project).serverPort),
+            val command = OpenCodeProcessEnvironment.terminalCommand(
+                listOf(
+                    executablePath,
+                    "attach",
+                    serverUrl(OpenCodeSettings.getInstance(project).serverPort),
+                )
             )
 
             val runner = LocalTerminalDirectRunner.createTerminalRunner(project)

src/main/kotlin/com/ashotn/opencode/relay/terminal/ReworkedTuiPanel.kt

@@ -3,6 +3,7 @@
 package com.ashotn.opencode.relay.terminal
 
 import com.ashotn.opencode.relay.OpenCodePlugin
+import com.ashotn.opencode.relay.OpenCodeProcessEnvironment
 import com.ashotn.opencode.relay.settings.OpenCodeSettings
 import com.ashotn.opencode.relay.util.serverUrl
 import com.intellij.openapi.Disposable
@@ -71,10 +72,12 @@ class ReworkedTuiPanel(
             }
 
             val workingDir = project.basePath ?: System.getProperty("user.home")
-            val command = listOf(
-                executablePath,
-                "attach",
-                serverUrl(OpenCodeSettings.getInstance(project).serverPort),
+            val command = OpenCodeProcessEnvironment.terminalCommand(
+                listOf(
+                    executablePath,
+                    "attach",
+                    serverUrl(OpenCodeSettings.getInstance(project).serverPort),
+                )
             )
             val manager = TerminalToolWindowTabsManager.getInstance(project)