Mac + Xray + I/O
A native macOS menu bar proxy client, powered by Xray-core.
Built to be lean and efficient — not packed with features you'll never use. It lives in your menu bar, does its job, and stays out of the way. No accounts, no telemetry, no clutter.
I relied on ClashX for years — it was the proxy client I opened every day on my Mac. Then, in late 2023, ClashX and the wider Clash ecosystem were taken down from GitHub. Its last release was v1.17.0, and it was never updated again. Because it was built on the older v2ray-core, it never supported newer Xray-core protocols like VLESS and REALITY.
I kept using it anyway — for years, even outdated — because nothing else felt right. The alternatives weren't truly native to macOS, or weren't as simple to live with day to day.
Eventually I built my own. Macxelio isn't trying to be the most powerful client out there — it's trying to be the most efficient one: fast, simple, lightweight, and native to the Mac. Just the things I need, done well.
- Menu bar control — switch proxies, change mode, and turn the system proxy or DNS on and off without opening a window. Every item shows its current state at a glance.
- Proxy modes — send everything through the proxy (Global), route only what matches your rules (Rule), or skip it entirely (Direct).
- Whole-Mac coverage — works across your system, not just the browser, by setting the macOS proxy and DNS for you.
- Protocols — Shadowsocks, VLESS, VMess, Trojan, SOCKS, and HTTP.
- Routing rules — decide what goes where by Domain, IP, GeoIP, or GeoSite, with Proxy / Direct / Block actions.
- Hosts & DNS — custom host mappings and DNS servers, including DNS-over-HTTPS (DoH), with optional system-wide DNS.
- Dev environments — set up proxy settings for your tools too: your shell, git, docker, editors (VS Code, Zed), and package managers (npm, pip, go).
- Live status — checks your connection on a timer and shows a clear status on the active proxy, with an instant recheck on demand from the menu or status badge.
- Connections — see what's connected and how it's being routed.
Macxelio runs on macOS 13.0 or later. It downloads the Xray-core it needs on first launch — there's nothing else to install.
- Download the latest release (
Macxelio-x.y.z.zip). - Unzip it and move Macxelio.app to your Applications folder.
- The app isn't notarized, so right-click Macxelio.app → Open the first time, then confirm.
Macxelio appears in your menu bar — there's no Dock icon or window on launch. If macOS still blocks the app, allow it under System Settings → Privacy & Security.
make run # build and launch
make release # universal release buildMIT