FAQ

Is Kumo a VPN?

No. Kumo is a proxy client that uses an existing subscription. It runs the Mihomo proxy engine locally and tells macOS to send traffic through it. There is no remote VPN server that Kumo connects to on its own.

Do I need a subscription?

Yes. Kumo is the client. A subscription URL from a proxy provider is required.

What Macs does it run on?

macOS 15 Sequoia or newer, on Apple Silicon (M1 / M2 / M3 / M4). Intel Macs are not supported in the first release.

Is it free? Is it open source?

Yes and yes. Kumo is licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). The source is at github.com/ProjectKumo/KumoApp.

Does Kumo ask for "Allow VPN Configuration"?

No. Kumo does not install a NetworkExtension and does not register a VPN profile. The "Allow VPN Configuration" prompt is not expected on first launch or at any other time.

Does Kumo work alongside another proxy app?

Other proxy apps can be installed, but only one can manage macOS's system proxy at a time. Two apps fighting for the same setting will look like Kumo's System Proxy toggle keeps flipping back to off.

Can I run Kumo headlessly?

Yes — most GUI functions are also exposed through the kumo command-line tool, so Kumo can be scripted. The menu bar icon and Shortcuts integration still need the GUI to be running. See Advanced → Command line.

How do I switch subscriptions?

Open Profiles, right-click the desired profile, and pick Set as Active. Only one profile is active at a time. To mix several, see Sub-Store.

Where does Kumo store settings and subscriptions?

Under ~/Library/Application Support/Kumo/. This path is not normally needed. For details, see File locations in the Advanced track.

How do I report a bug?

Open an issue at github.com/ProjectKumo/KumoApp/issues. The Troubleshooting page lists what to include.

Can I help build Kumo?

Yes. See the Contributing track. It covers building from source, the codebase structure, and how to file a good PR.