iOS Shortcuts Examples

ZestSSH’s zestssh:// URL scheme works with iOS Shortcuts, enabling voice-triggered server commands via Siri and automated workflows.

How It Works

iOS Shortcuts can open URLs, which triggers ZestSSH’s automation handler. Create a shortcut with an “Open URL” action pointing to a zestssh:// endpoint.

Prerequisites

• ZestSSH Squeezed (automation requires Squeezed)
• Automation enabled in ZestSSH Settings
• An API key created in Settings > Automation > Manage API Keys

Example 1: Quick Server Status

Purpose: Ask Siri “Server status” to check if your main server is responding.

Shortcut: “Server Status”

1. Open the Shortcuts app.
2. Create a new shortcut named “Server Status”.
3. Add action: Open URL

   zestssh://execute?connection=MainServer&command=uptime && echo "OK"&key=YOUR_KEY&timeout=10

4. Tap the shortcut name and set a Siri Phrase: “Server status”

Usage: Say “Hey Siri, Server status” and ZestSSH connects to your server, runs uptime, and shows the result.

Adding a Notification

To get a notification with the result instead of switching to ZestSSH:

1. After the Open URL action, add a Wait action (5 seconds).
2. Add a Show Notification action with a static confirmation message.

Note: iOS Shortcuts cannot directly read the output from a zestssh:// URL. For one-way “fire and trigger” actions, this works well. For result-dependent logic, put the command in a saved Workflow with a webhook configured on it inside ZestSSH, then trigger that workflow from the Shortcut:

zestssh://workflow?name=Uptime%20check&key=YOUR_KEY

The workflow’s own webhook posts the result to a push notification service such as ntfy.sh, which then notifies your phone. A callback parameter placed in the URL itself is deliberately ignored, so a link can never choose where your output is sent.

Example 2: Restart a Service

Purpose: Quickly restart nginx on your web server.

Shortcut: “Restart Nginx”

1. Create a new shortcut named “Restart Nginx”.
2. Add action: Open URL

   zestssh://execute?connection=WebServer&command=sudo systemctl restart nginx && echo "nginx restarted"&key=YOUR_KEY&timeout=15

3. Set a Siri Phrase: “Restart nginx”

With Confirmation

To prevent accidental triggers, add a confirmation step:

1. Add action: Show Alert
   • Title: “Restart nginx?”
   • Message: “This will restart nginx on WebServer.”
   • Buttons: “Restart” / “Cancel”
2. Add action: If (result is “Restart”)
3. Add action: Open URL (the zestssh:// URL)
4. End If

Example 3: Morning Server Report

Purpose: Run as part of a morning automation to check multiple servers.

Shortcut: “Morning Servers”

1. Create a new shortcut named “Morning Servers”.

2. Add action: Open URL

   zestssh://batch?connections=Web1,Web2,DB1&command=echo "$(hostname): $(uptime -p), disk $(df -h / | awk 'NR==2{print $5}')"&key=YOUR_KEY&parallel=true&timeout=20

3. Set a Siri Phrase: “Morning servers”

Incorporating into a Morning Routine

Add “Morning Servers” as a step in an existing Shortcuts automation:

1. Open Shortcuts > Automation.
2. Create a Personal Automation triggered at a specific time (e.g. 7:30 AM).
3. Add your existing morning routine actions (weather, calendar, etc.).
4. Add action: Run Shortcut > “Morning Servers”

Siri Phrase Suggestions

Phrase	Action
”Server status”	Check main server uptime
”Restart nginx”	Restart web server
”Check containers”	List Docker container status
”Run backup”	Trigger backup script
”Deploy staging”	Deploy to staging server
”Morning servers”	Batch check all servers

Limitations on iOS

• No stdout capture: iOS Shortcuts cannot read the return value from a zestssh:// URL, and a callback parameter in the URL is ignored by design. For result-dependent workflows, configure the webhook on a saved Workflow inside ZestSSH and trigger it with zestssh://workflow; the workflow POSTs its result to your external service (ntfy.sh, a webhook, etc.).
• Background execution: iOS may suspend ZestSSH if it takes too long. Keep timeouts reasonable (under 30 seconds for Siri-triggered actions).
• App switch: Opening a zestssh:// URL briefly switches to ZestSSH. The user sees a flash of the app before returning to Shortcuts. This is an iOS limitation for URL scheme handlers.

Advanced: Shortcuts with Variables

Use Shortcuts’ “Ask for Input” or “Choose from Menu” actions to build dynamic commands:

1. Ask for Input: “Which branch to deploy?”
2. Set Variable: branch = input
3. Open URL:

   zestssh://snippet?connection=Staging&name=deploy-branch&var_branch=[branch]&key=YOUR_KEY

Replace [branch] with the Shortcuts variable reference.