feat(installer): configure mind-map MCP in OpenCode + fix silent-failure bug

OpenCode (https://opencode.ai) is now detected and configured alongside
Claude / Copilot / VS Code / Cursor. Its MCP shape differs:

  - top-level key 'mcp' (not 'mcpServers')
  - command is a JSON array (not string + separate args)
  - 'enabled': true is expected
  - schema URL pointer

A new configure_opencode() function emits and merges this shape. Detection
follows the same pattern used for other clients: the config file already
exists, the config directory has been created, or the 'opencode' binary
is on PATH. On Linux/macOS we write ~/.config/opencode/opencode.json; on
Windows %APPDATA%\opencode\opencode.json.

SKILL.md gets dropped into the new client's primary skill discovery path
too (~/.config/opencode/skills/mind-map/SKILL.md and
%APPDATA%\opencode\skills\mind-map\), although OpenCode already finds
SKILL.md via its ~/.claude/skills/ and ~/.agents/skills/ fallback paths
which the installer was already writing.

Also fixes a pre-existing silent-failure bug in configure_mcp_client: the
embedded python3 block interpolated the JSON entry string directly into
Python source via shell quoting. For any existing config file (i.e. any
real-world install where Claude/Copilot/Cursor/VS Code is already set
up), Python raised SyntaxError on the embedded double-quotes, the error
was redirected to /dev/null, and the script reported '! could not
update' with no diagnostics. The fix passes the JSON entry via an
environment variable instead, which sidesteps the quoting altogether.
Verified end-to-end in the devcontainer against both fresh-file and
merge-into-existing scenarios for both the OpenCode and Claude shapes.

Author: aniongithub

install.ps1

@@ -125,6 +125,7 @@ $SkillDirs = @(
     "$env:USERPROFILE\.copilot\skills\mind-map"
     "$env:USERPROFILE\.claude\skills\mind-map"
     "$env:USERPROFILE\.agents\skills\mind-map"
+    "$env:APPDATA\opencode\skills\mind-map"
 )
 
 foreach ($dir in $SkillDirs) {
@@ -288,6 +289,62 @@ if (Test-Path "$env:USERPROFILE\.cursor") {
     Set-McpConfig "$env:USERPROFILE\.cursor\mcp.json" "Cursor"
 }
 
+# OpenCode (https://opencode.ai) — different config shape: top-level "mcp"
+# (not "mcpServers"), command is an array, and entries carry "enabled": true.
+# Primary path on Windows is %APPDATA%\opencode\opencode.json; the script also
+# accepts the .jsonc variant if it's the file the user already has.
+$openCodeEntry = [PSCustomObject]@{
+    type    = "local"
+    command = @($BinaryPath)
+    enabled = $true
+}
+
+function Set-OpenCodeMcpConfig {
+    param([string]$ConfigPath)
+    try {
+        if (Test-Path $ConfigPath) {
+            $content = Get-Content -Raw $ConfigPath | ConvertFrom-Json
+            if (-not $content.mcp) {
+                $content | Add-Member -NotePropertyName "mcp" -NotePropertyValue ([PSCustomObject]@{})
+            }
+            if ($content.mcp.PSObject.Properties.Name -contains "mind-map") {
+                $content.mcp.PSObject.Properties.Remove("mind-map")
+            }
+            $content.mcp | Add-Member -NotePropertyName "mind-map" -NotePropertyValue $openCodeEntry
+            $content | ConvertTo-Json -Depth 10 | Set-Content $ConfigPath -Encoding UTF8
+            Write-Ok "OpenCode — configured in $ConfigPath"
+        } else {
+            $dir = Split-Path $ConfigPath -Parent
+            if ($dir) { New-Item -ItemType Directory -Path $dir -Force | Out-Null }
+            $config = [PSCustomObject]@{
+                '$schema' = "https://opencode.ai/config.json"
+                mcp       = [PSCustomObject]@{
+                    "mind-map" = $openCodeEntry
+                }
+            }
+            $config | ConvertTo-Json -Depth 10 | Set-Content $ConfigPath -Encoding UTF8
+            Write-Ok "OpenCode — created $ConfigPath"
+        }
+    } catch {
+        Write-Warn "OpenCode — could not update $ConfigPath"
+    }
+}
+
+$openCodeDir = "$env:APPDATA\opencode"
+$openCodeJson = Join-Path $openCodeDir "opencode.json"
+$openCodeJsonc = Join-Path $openCodeDir "opencode.jsonc"
+$openCodeCfg = $null
+if (Test-Path $openCodeJson) {
+    $openCodeCfg = $openCodeJson
+} elseif (Test-Path $openCodeJsonc) {
+    $openCodeCfg = $openCodeJsonc
+} elseif ((Test-Path $openCodeDir) -or (Get-Command opencode -ErrorAction SilentlyContinue)) {
+    $openCodeCfg = $openCodeJson
+}
+if ($openCodeCfg) {
+    Set-OpenCodeMcpConfig $openCodeCfg
+}
+
 # ---------------------------------------------------------------------------
 # Done
 # ---------------------------------------------------------------------------
@@ -305,4 +362,4 @@ Write-Host "To uninstall mind-map completely:" -ForegroundColor DarkGray
 Write-Host "  mind-map service uninstall                        # remove service (if installed)" -ForegroundColor DarkGray
 Write-Host "  Remove-Item -Recurse '$InstallDir'                # remove binary" -ForegroundColor DarkGray
 Write-Host "  Remove-Item -Recurse '$env:USERPROFILE\.mind-map' # remove wiki data" -ForegroundColor DarkGray
-Write-Host "  Remove-Item -Recurse '$env:USERPROFILE\.copilot\skills\mind-map', '$env:USERPROFILE\.claude\skills\mind-map', '$env:USERPROFILE\.agents\skills\mind-map'" -ForegroundColor DarkGray
+Write-Host "  Remove-Item -Recurse '$env:USERPROFILE\.copilot\skills\mind-map', '$env:USERPROFILE\.claude\skills\mind-map', '$env:USERPROFILE\.agents\skills\mind-map', '$env:APPDATA\opencode\skills\mind-map'" -ForegroundColor DarkGray

install.sh

@@ -127,6 +127,7 @@ SKILL_DIRS=(
   "${HOME}/.copilot/skills/mind-map"
   "${HOME}/.claude/skills/mind-map"
   "${HOME}/.agents/skills/mind-map"
+  "${HOME}/.config/opencode/skills/mind-map"
 )
 
 echo ""
@@ -265,23 +266,68 @@ configure_mcp_client() {
 MCPEOF
     echo "  + ${client_name} -- created ${config_file}"
   elif command -v python3 >/dev/null 2>&1; then
-    python3 -c "
-import json
-path = '${config_file}'
+    # Pass values via env vars to avoid shell-quoting the JSON literal into
+    # Python source code (which breaks on every embedded double-quote).
+    MM_CFG="$config_file" MM_ENTRY="$mcp_entry" MM_CLIENT="$client_name" \
+    python3 -c '
+import json, os
+path = os.environ["MM_CFG"]
+client = os.environ["MM_CLIENT"]
 with open(path) as f:
     data = json.load(f)
-servers = data.setdefault('mcpServers', {})
-entry = json.loads('${mcp_entry}')
-servers['mind-map'] = entry
-with open(path, 'w') as f:
+servers = data.setdefault("mcpServers", {})
+servers["mind-map"] = json.loads(os.environ["MM_ENTRY"])
+with open(path, "w") as f:
     json.dump(data, f, indent=2)
-print('  + ${client_name} -- updated ${config_file}')
-" 2>/dev/null || echo "  ! ${client_name} -- could not update ${config_file}"
+print(f"  + {client} -- updated {path}")
+' || echo "  ! ${client_name} -- could not update ${config_file}"
   else
     echo "  ! ${client_name} -- exists but python3 not available to merge"
   fi
 }
 
+# OpenCode uses a different MCP config shape than Claude/Copilot/VS Code/Cursor:
+#   - Top-level key is "mcp" (not "mcpServers")
+#   - command is an array (not a string + separate args)
+#   - "enabled": true is expected on the entry
+#   - JSONC (JSON with comments) is supported but we always emit plain JSON
+# See https://opencode.ai/docs/mcp-servers
+configure_opencode() {
+  local config_file="$1"
+
+  # OpenCode entry, written with command as a JSON array.
+  local mcp_entry
+  mcp_entry="{\"type\": \"local\", \"command\": [\"${INSTALL_DIR}/mind-map\"], \"enabled\": true}"
+
+  if [ ! -f "$config_file" ]; then
+    mkdir -p "$(dirname "$config_file")"
+    cat > "$config_file" << OPENCODEEOF
+{
+  "\$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "mind-map": ${mcp_entry}
+  }
+}
+OPENCODEEOF
+    echo "  + OpenCode -- created ${config_file}"
+  elif command -v python3 >/dev/null 2>&1; then
+    MM_CFG="$config_file" MM_ENTRY="$mcp_entry" \
+    python3 -c '
+import json, os
+path = os.environ["MM_CFG"]
+with open(path) as f:
+    data = json.load(f)
+servers = data.setdefault("mcp", {})
+servers["mind-map"] = json.loads(os.environ["MM_ENTRY"])
+with open(path, "w") as f:
+    json.dump(data, f, indent=2)
+print(f"  + OpenCode -- updated {path}")
+' || echo "  ! OpenCode -- could not update ${config_file}"
+  else
+    echo "  ! OpenCode -- exists but python3 not available to merge"
+  fi
+}
+
 echo ""
 echo "==> Configuring MCP clients..."
 
@@ -308,6 +354,22 @@ fi
 # Claude Code
 configure_mcp_client "${HOME}/.claude.json" "Claude Code"
 
+# OpenCode (https://opencode.ai). The studio reads opencode.json first, then
+# opencode.jsonc. If neither exists but the binary is on PATH or the config
+# directory has been created, we write the canonical .json so future runs
+# pick it up.
+OPENCODE_CFG=""
+if [ -f "${HOME}/.config/opencode/opencode.json" ]; then
+  OPENCODE_CFG="${HOME}/.config/opencode/opencode.json"
+elif [ -f "${HOME}/.config/opencode/opencode.jsonc" ]; then
+  OPENCODE_CFG="${HOME}/.config/opencode/opencode.jsonc"
+elif [ -d "${HOME}/.config/opencode" ] || command -v opencode >/dev/null 2>&1; then
+  OPENCODE_CFG="${HOME}/.config/opencode/opencode.json"
+fi
+if [ -n "$OPENCODE_CFG" ]; then
+  configure_opencode "$OPENCODE_CFG"
+fi
+
 echo ""
 if [ "$INSTALL_SERVICE" = "y" ] || [ "$INSTALL_SERVICE" = "Y" ]; then
   echo "Done! mind-map is running as a service."
@@ -321,5 +383,5 @@ echo "To uninstall mind-map completely:"
 echo "  sudo mind-map service uninstall   # remove service (if installed)"
 echo "  rm ${INSTALL_DIR}/mind-map        # remove binary"
 echo "  rm -rf ~/.mind-map                # remove wiki data"
-echo "  rm -rf ~/.copilot/skills/mind-map ~/.claude/skills/mind-map ~/.agents/skills/mind-map"
+echo "  rm -rf ~/.copilot/skills/mind-map ~/.claude/skills/mind-map ~/.agents/skills/mind-map ~/.config/opencode/skills/mind-map"
 echo ""