Browse the docs

switchboard apps

Lists the Mac apps whose actions Switchboard offers as steps; rescans, searches, adds the Shortcuts bridge, runs an action.

Details #

switchboard apps prints one line per app: a dot (off when you switched the app off), the name, how many actions, events and states it offers, and the runner that would run it. [open only] means its actions cannot run yet: add the Shortcuts bridge in Settings › App Actions (or update it, if the app is new since).

switchboard apps
switchboard apps --json
switchboard apps rescan
switchboard apps search complete todo
switchboard apps bridge
switchboard apps bridge --check
switchboard apps run Day:AddToInboxIntent text="Call dentist"

bridge makes, signs and opens the one shortcut "Switchboard Bridge" for every switched-on app; click Add Shortcut (or Replace) once, then --check finds it and remembers which apps it holds. run runs one action through the engine, the way a macro step would.

search prints each hit's step type, which is what a macro stores (app.com.example.App.DoThingIntent).

Parameters #

switchboard apps [--json]
switchboard apps rescan | apps search <words…>
switchboard apps bridge [--check]
switchboard apps run <App>:<Intent> [name=value…] run one app action now

The Mac apps whose actions Switchboard offers as steps.

Look for new apps; find an action across all of them.

Add the Shortcuts bridge, one shortcut for every app (--check: look for it).

Gotchas #

  • Exit code 69 means the engine is not running.

See also #

GET /apps, Use your apps' actions