Daily use
The dashboard, the menu bar, the system proxy toggle, and what each card shows.
With a profile loaded and Kumo running, the typical workflow is small: check the Overview screen, pick a node from Proxies, and leave it running from the menu bar.
Overview screen
The Overview screen has two areas:
- Left: a large status card showing whether Kumo is running, the current outbound mode, the active profile, and a Start / Stop button.
- Right: four small cards — Profile, Traffic, System Proxy, TUN — each displaying one specific metric.
Drag the divider between left and right to resize. Kumo remembers the position.
Status card
The status card has three states:
- Stopped — the proxy is off. Click Start to bring it up.
- Running — the proxy is on. Shows the active profile and outbound mode.
- Error — something went wrong. Displays a short message. See Troubleshooting.
Four small cards
| Card | What it shows |
|---|---|
| Profile | The active profile name, traffic used, and a Refresh button. |
| Traffic | Live upload and download, plus a 60-second chart. |
| System Proxy | Whether macOS is sending traffic through Kumo, with a toggle. |
| TUN | Whether Kumo is routing the entire Mac's traffic. See Advanced. |
If Kumo is Stopped, the cards show the last known values so they remain visible before starting the core again.
Proxies screen
Switch to Proxies in the sidebar to see groups and nodes.
- The first level lists the groups in the subscription (often a "Proxy" group, plus groups like "Streaming" or "Direct").
- Click a group to see its members — the actual proxy nodes.
- For a select group, click any node to pick it. Kumo remembers the choice and tells Mihomo.
- For an automatic group (URLTest, Fallback, LoadBalance), the group manages its own selection. Kumo shows the current pick but it cannot be overridden directly.
Each node displays a country flag (when detectable) and a latency pill that turns green / orange / red based on the last test. Click Test Latency on a group to refresh the numbers.
Menu bar
A Kumo icon sits in the menu bar. Click it to open a small menu with common controls:
- Start / Stop the core.
- Switch the outbound mode (Rule / Global / Direct).
- Toggle the system proxy.
- Open the main window.
- Quit Kumo.
The icon changes shape based on the current state — solid when running, hollow when stopped, with a small badge when attention is needed.
If the menu bar icon is not visible, another app (Bartender, Hidden Bar, iStat Menus) may be hiding it. Open Settings → General and check that Show menu bar icon is on.
Sub-Store screen
Kumo bundles Sub-Store, a tool for managing multiple proxy subscriptions in one place. It can be ignored if a single subscription URL is sufficient. See Sub-Store for details.
Other destinations
Most users remain in Overview and Proxies. The other sidebar destinations — Connections, Logs, Rules, Core, System Proxy, TUN, DNS — serve specific purposes:
- Connections shows which app is using the proxy right now.
- Logs shows Mihomo output when diagnosing issues.
- Core, System Proxy, TUN, DNS provide fine control. Defaults are sufficient for most users.
For details on any of these, see the Advanced track.