Spotlight, Shortcuts & Siri
Corral declares macOS App Intents, so your projects and services become actions the system knows about — usable from Spotlight, the Shortcuts app, and Siri. Type a project’s name into Spotlight to open it, say “Start a Corral project” to Siri, or drop a Corral action into a Shortcut that runs when you plug in your external display.
Because Corral caches your project roster on disk, these actions find your projects even when the app is closed and the daemon isn’t running — and a start or open action brings Corral up on its own.
What you can do
Projects
| Action | What it does |
|---|---|
| Open | Bring a project up in the app |
| Start · Stop · Restart | Control a project’s dev server |
| Open URL | Open the project’s URL in your browser |
| Share | Start a public tunnel and hand back the URL |
| Open in Editor | Open the project in its editor |
Lists — Get Projects (all) and Get Running Projects return a list of projects, so a Shortcut can loop over them and feed each into another action.
Services PRO — Start Service and Stop Service. See Managing services.
Stacks — Open Stack, Get Stacks, and Get Running Stacks are free; Start Stack, Stop Stack, and Restart Stack PRO bring a whole stack — its projects and services — up or down at once (running a stack is a Pro feature, like the services it contains).
Spotlight
Type a project’s name into Spotlight and it shows up as a result — select it to open the project, or run one of its actions inline. This works because Corral indexes your projects with the system; there’s nothing to configure.
Shortcuts app
Open the Shortcuts app and you’ll find ten ready-made Corral shortcuts already there on install — a curated set of the project, service, and stack actions above, each ready to drop into a workflow. You can also build your own from any Corral action (including Restart, or a couple of the project actions, which aren’t in the pre-built set only because Apple caps a catalog at ten).
Because the list actions return a list of projects, you can chain them — “get every running project, then stop each one” is a two-step Shortcut. Pair Corral actions with automation triggers (time of day, an app launching, a display connecting, joining a Wi-Fi network) to bring your stack up exactly when you need it.
Siri
Ask Siri with the built-in phrases — “Start a Corral project”, “Start a Corral stack”, “Share a Corral project”, “What’s running in Corral” — and it prompts you to pick which one. Names are chosen in the moment from your live list rather than baked into the spoken phrase.
Managing services
The two service actions — Start Service and Stop Service PRO — need Corral Pro, since managed services are a Pro feature. On the free tier they return a clean “Corral Pro required” message instead of failing cryptically. Learn more → or activate a license.
Where to find it
The macOS app’s Settings → Automations panel lists the ready-made shortcuts and opens the Shortcuts app. There’s no on/off switch — macOS decides when to surface Corral’s actions.
Prefer a URL you can click or script? Deep Links drive the same project, service, and stack actions through the corral:// scheme.