OnlySwitch Deeplink

Invoke OnlySwitch built-in switches or one-shot buttons by opening its deeplink. OnlySwitch must be installed and allowed to handle the onlyswitch:// URL scheme.

Workflow

1. Resolve intent to switch id

Map the user's request to a single built-in switch/button using [references/switch-ids.md](references/switch-ids.md). Match phrases like "empty trash", "toggle keep awake", "mute mic", "clear xcode cache" to the correct id (e.g. empty trash → 16384, keep awake → 16).

1. Open the deeplink

Run on the user's machine (macOS):

``bash open "onlyswitch://run?type=builtIn&id=<id>" ``

Replace <id> with the numeric id from the reference table. Example for "empty trash":

``bash open "onlyswitch://run?type=builtIn&id=16384" ``

1. Confirm

Tell the user which action was triggered (e.g. "Emptied trash via OnlySwitch" or "Toggled Keep Awake via OnlySwitch").

Notes

• One deeplink per request: resolve to exactly one switch id per user message.
• If the request doesn't match any built-in (e.g. custom switch or unknown action), say that OnlySwitch deeplinks only support the built-in list and suggest checking the app or docs.
• IDs are raw enum values from SwitchType in the OnlySwitch app (see project's SwitchType.swift for the source of truth; this skill's reference table is derived from it).