Advanced

The Advanced track covers everything outside the GUI: the kumo CLI, custom profiles, overrides, automation hooks, and the agent-skill bundle for coding agents.

All of these features are built on the same KumoCoreKit facade the GUI uses, so the command line and the GUI always agree on state.

Topics

Command line

Install the kumo CLI, run it from anywhere, get tab-completion.

CLI reference

Every command, every flag. Predictable JSON output for scripts and agents.

Profiles reference

Local YAML, remote subscriptions, refresh policy, useProxy.

Overrides

Tweak a subscription without forking it. Merge operators, examples, caveats.

Sub-Store hosting

Host a Sub-Store backend and point Kumo at it.

Automation

Shortcuts, App Intents, Spotlight, Services.

Agent skills

Give a coding agent safe, structured access to the CLI.

Keyboard shortcuts

Every key Kumo listens to.

File locations

Where Kumo stores data and what each file means.

Permissions

What macOS asks for and why, plus what Kumo deliberately does not do.

Auto-update internals

How the update flow works under the hood, channels, manifests.

Conventions

Code examples are real commands. Copy and run them.
JSON examples use the actual output shape — { ok, data?, error? } — that scripts and agents can branch on.
Where the GUI covers the same topic, the page links back to the Getting Started version.

For the engineering rationale behind these decisions, see the Contributing track.