YTwsy/OpenSurge-for-Mac

Surge-style whole-home gateway and control plane for macOS with IPv4/IPv6 support— mihomo TUN, dnsmasq-powered DHCP/DNS, per-device routing, and an agent-friendly validation workspace.

About the project

OpenSurge for Mac turns a Mac into a Surge-style gateway that can transparently proxy and route traffic for devices on a home network. It is for users who need per-device routing, DHCP and DNS control, proxy subscriptions, and a local interface for monitoring network state; its catalogue instruction supports an agent-friendly workspace for validating and operating the project.

Latest release v0.2.1 — OpenSurge for Mac v0.2.1 — Wind Rose · 22 Aug 2026

These files are YTwsy/OpenSurge-for-Mac's own configuration. They tell Codex and OpenCode how to work on this repository, so they are not mods to install elsewhere. Copy one as a starting point and replace the parts that are about this project.

2,324Stars on the repository
1Files it configures its agents with
1,122Tokens loaded in every session
2Agents configured

Instructions