opencode run: MCP child processes not terminated on exit (orphan leak)

[the3asic]

Summary

opencode run spawns MCP server processes (e.g., mcp-searxng, mcp-tavily, sequential-thinking, etc.) but does not terminate them when the run session exits. These processes get reparented to PID 1 and persist indefinitely, causing significant memory leaks over time.

Reproduction

1. Configure MCP servers in opencode.json (e.g., mcp-searxng)
2. Run opencode run "any prompt" — MCP servers are spawned as child processes
3. After opencode run completes and exits, check: ps -eo pid,ppid,args | grep mcp-searxng
4. The MCP processes are still alive with PPID=1 (orphaned)

Impact

In a cron-based setup (e.g., heartbeat scripts calling opencode run every 30 minutes), orphaned MCP processes accumulate rapidly:

• Each mcp-searxng process consumes ~61MB RSS
• ~90 opencode run invocations/day = ~5.5GB/day leaked
• Observed: 301 orphaned mcp-searxng processes consuming ~18GB before manual cleanup

Environment

• OpenCode version: 1.3.0
• OS: Ubuntu 20.04 (ARM64, Oracle Cloud)
• MCP servers configured: searxng, tavily, sequential-thinking, zhipu-vision, github-search, websearch

Expected Behavior

opencode run should send SIGTERM to all spawned MCP child processes before exiting (or use a process group so they all terminate together).

Current Workaround

Cron script that periodically kills orphaned MCP processes (PPID=1):

#!/usr/bin/env bash
MCP_PATTERNS="mcp-searxng|mcp-tavily|sequential-thinking|github-search|zhipu-vision|websearch"
while IFS= read -r line; do
    pid=$(echo "$line" | awk '{print $1}')
    ppid=$(echo "$line" | awk '{print $2}')
    [ "$ppid" = "1" ] && kill "$pid" 2>/dev/null
done < <(ps -eo pid,ppid,args | grep -E "$MCP_PATTERNS" | grep -v grep)

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• [Bug] MCP processes not terminated after session ends #6633: MCP processes not terminated after session ends (same core problem, now closed - may have been prematurely closed or not fully fixed)
• v1.1.6 still has memory bloat - heap not released + MCP orphan processes #7261: MCP orphan processes accumulating across sessions (includes the same MCP orphan subprocess issue)
• Memory leak: serve and web commands leak child processes on exit; SSE heartbeat interval leaks on server-initiated close #14091: serve and web commands leak child processes on exit; no graceful shutdown / SIGTERM handling (same root cause - no cleanup on exit)
• Missing SIGHUP handler causes orphaned processes to leak ~4.7 GB each after terminal death #14504: Missing SIGHUP handler causes orphaned processes to leak (related orphan process / missing signal handler issue)
• Memory Leak: Orphaned processes when terminal closes without explicit exit #10563: Orphaned processes when terminal closes without explicit exit (similar orphan process accumulation)

If your issue is specifically about the opencode run (non-interactive/headless) command not cleaning up MCP subprocesses, and none of the above cover that exact path, please clarify that distinction so maintainers can triage accordingly.

[nexxeln]

fixed in #15516