[FEATURE]: Built-in proxy support with auto-start/stop for restricted network environments

[tianshan233]

Feature hasn't been suggested before.

• I have verified this feature hasn't been suggested before.

Describe the enhancement you want to request

OpenCode relies heavily on network access (webfetch, package installs, git clone, etc.), but many developers work behind network restrictions that require proxy access. Currently there is no built-in proxy support.

Proposal: Add built-in proxy configuration and auto-start/stop capabilities to OpenCode.

Suggested Implementation

// opencode.jsonc
{
  proxy: {
    enabled: true,
    host: 127.0.0.1,
    port: 7890,
    protocol: http,
    // Optional: auto-start a local proxy core
    auto_start: {
      core_path: C:\\path\\to\\mihomo.exe,
      subscription_url: https://...
    }
  }
}

Use Case

1. Agent runs webfetch → times out due to network restriction
2. OpenCode auto-starts the configured proxy core
3. Network requests go through proxy → succeeds
4. After task completion, proxy auto-shuts down

This would be especially helpful for developers in regions with internet restrictions.

Reference Implementation

We built a small PowerShell tool that does exactly this for OpenCode agents: https://github.com/tianshan233/auto-proxy

It demonstrates the full workflow: download subscription → start Mihomo core → set proxy → work → auto cleanup.

[tianshan233]

中文说明 / Chinese Description

由于这个问题主要影响中国开发者，以下是中文补充说明：

背景： OpenCode 在执行 webfetch、winget install、git clone 等网络操作时，国内用户经常遇到超时/无法访问的问题。目前 OpenCode 没有内置代理支持，每次网络超时都需要人工干预。

建议： 在 opencode.json 中添加代理配置，支持自动启停：

{
  proxy: {
    enabled: true,
    host: 127.0.0.1,
    port: 7890,
    auto_start: {
      core_path: mihomo.exe,
      subscription_url: https://...
    }
  }
}

参考实现： 我们做了一个 PowerShell 工具实现这个工作流：tianshan233/auto-proxy

流程：网络超时 → 自动下载订阅 → 启动 Mihomo 核心 → 设置代理 → 完成任务 → 自动关闭

希望能帮到更多国内开发者~

[github-actions]

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

• [Desktop][Windows] webfetch tool does not respect system proxy settings — feature request: add proxy config in settings UI #27892: Similar feature request for built-in proxy configuration in opencode.json (also targeting restricted network environments on Windows)
• [FEATURE]: Support explicit proxy configuration in opencode config #24981: Closed feature request proposing an almost identical proxy config block in opencode.jsonc for scoped proxy support

The core ask — a proxy field in the opencode config — overlaps significantly with both. It may be worth adding your auto_start use case as a comment on #27892 rather than tracking it separately.

[tianshan233]

Thanks for the review! While #27892 and #24981 are related, this proposal goes significantly further.

Key Difference -- Full Lifecycle Automation:

	#27892 / #24981	This Proposal (#37993)
Approach	Passive: respect system proxy or add static config field	Active: automated workflow
Proxy startup	User must manually start proxy	OpenCode auto-starts proxy core
Core integration	None	Built-in Mihomo/Clash core launcher
Subscription	N/A	Auto-download subscription config
Cleanup	User manually stops	Auto-shutdown after task complete

Workflow:
Network timeout -> auto-detect -> download subscription -> start Mihomo core -> set proxy -> retry request -> task done -> auto stop

The existing issues just add a config field for an already-running proxy. This proposal lets OpenCode manage the entire proxy lifecycle automatically.

Happy to move this to #27892 if preferred, but the auto-start/stop workflow deserves dedicated consideration.

Reference: https://github.com/tianshan233/auto-proxy

[tianshan233]

中文说明 / Chinese Context

感谢审核！虽然 #27892 和 #24981 相关问题，但本提案有本质区别。

核心差异 — 全生命周期自动化：

	#27892 / #24981	本提案 (#37993)
方式	被动：遵循系统代理或静态配置	主动：自动化工作流
代理启动	用户手动开启	OpenCode 自动启动代理核心
核心集成	无	内置 Mihomo/Clash 核心启动
订阅管理	无	自动下载订阅配置
清理	用户手动关闭	任务完成后自动关闭

工作流：
网络超时 → 自动检测 → 下载订阅 → 启动 Mihomo 核心 → 设置代理 → 重试请求 → 任务完成 → 自动关闭

已有 issue 只是"给已在运行的代理加个配置项"，本提案是"OpenCode 全自动管理代理生命周期"，根本是不同维度的方案。

参考实现： https://github.com/tianshan233/auto-proxy