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
- •
Resolve intent to switch id
Map the user's request to a single built-in switch/button using 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). - •
Open the deeplink
Run on the user's machine (macOS):bashopen "onlyswitch://run?type=builtIn&id=<id>"
Replace
<id>with the numeric id from the reference table. Example for "empty trash":bashopen "onlyswitch://run?type=builtIn&id=16384"
- •
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
SwitchTypein the OnlySwitch app (see project'sSwitchType.swiftfor the source of truth; this skill's reference table is derived from it).