The Action Library
Every step type Zeshort can run — 62 actions across 8 categories.
Each card shows the action's type
(what you write in a .zs file),
what it reads as input, and what it passes on as output.
33 of 62 run fully headlessly — from the CLI or an AI agent over MCP, with no window open.
The rest need a UI surface or an external provider that isn't wired up yet, and report a clean
unsupported
result rather than silently pretending to succeed.
Scripting
14Show Result
show-result
Displays the current output in the runner.
Ask for Input
ask-input
Prompts the user for text, a number, or a URL.
Show Alert
alert
Displays a modal message that needs acknowledgement.
Comment
comment
Adds a note that does not run.
Set Variable
set-variable
Stores a value under a reusable name — leave the parameter empty to capture the previous output. Reference it later as {name}.
Get Variable
get-variable
Reads a value saved earlier in the shortcut.
If
if
Runs a branch only when a condition matches. Needs nested steps — not executable yet.
Repeat
repeat
Repeats the nested actions a fixed number of times. Needs nested steps — not executable yet.
Repeat with Each
repeat-each
Runs the nested actions once for each item in a list. Needs nested steps — not executable yet.
Choose from Menu
choose-menu
Presents named options and continues from the selected option.
Choose from List
choose-list
Lets the user select one or more items from a list.
Get Item from List
get-list-item
Gets the first, last, random, or indexed item from the previous output.
Count
count
Counts items, characters, words, or lines.
Wait
wait
Pauses execution for a number of seconds.
Text
9Text
text
Provides plain text to the next action.
Get Text from Input
get-text
Extracts readable text from the current input.
Combine Text
combine-text
Joins a list of text values with a separator.
Replace Text
replace-text
Finds and replaces text in the previous output.
Split Text
split
Divides text into a list by lines, spaces, commas, or custom text.
Change Case
change-case
Converts text to uppercase, lowercase, or title case.
Trim Whitespace
trim-whitespace
Removes extra spaces and blank lines from text.
Speak Text
speak
Reads text aloud using the system speech engine when available.
Translate Text
translate-text
Translates text through the configured translation provider.
OpenAI
8OpenAI Text Response
openai-response
Calls the OpenAI Responses endpoint with a prompt and optional previous output.
OpenAI Vision
openai-vision
Analyzes an image URL or file reference through a vision-capable OpenAI model.
OpenAI Text to Speech
openai-tts
Generates speech audio from text through the OpenAI audio speech endpoint.
OpenAI Transcribe Audio
openai-transcribe
Transcribes an audio file through the OpenAI audio transcription endpoint.
OpenAI Translate Audio
openai-translate-audio
Translates an audio file into English through the OpenAI audio translations endpoint.
OpenAI Image Generation
openai-image
Creates an image from a prompt through the OpenAI image generation endpoint.
OpenAI Embedding
openai-embedding
Creates vector embeddings from text through the OpenAI embeddings endpoint.
OpenAI Custom Endpoint
openai-custom
Prepares a custom OpenAI API call with an endpoint path and JSON body.
Zallama
3Zallama Text Response
zallama-response
Calls a local Zallama (OpenAI-compatible) server with a prompt and optional previous output.
Zallama Chat
zallama-chat
Sends a system prompt and user message to a local Zallama (OpenAI-compatible) chat endpoint.
Zallama Embedding
zallama-embedding
Creates vector embeddings from text through a local Zallama (OpenAI-compatible) embeddings endpoint.
Media
7Find Media
find-media
Searches images, videos, or audio from a selected folder or library.
Get Latest Media
get-latest-media
Gets the most recent images, videos, or audio items.
Save Media
save-media
Saves generated or selected media to a folder.
Resize Image
resize-image
Resizes an image to a target width, height, or percentage.
Crop Image
crop-image
Crops an image to a rectangle or aspect ratio.
Play Audio
play-audio
Plays an audio file or stream.
Transcribe Audio
transcribe-audio
Turns speech in an audio file into text.
Apps
10Send Email
send-email
Opens the default mail client with recipient, subject, and body prefilled.
Add Calendar Event
add-calendar-event
Creates a calendar event through a configured calendar provider.
Add Reminder
add-reminder
Creates a task in the configured reminders provider.
Open App
open-app
Launches an installed app by name or path.
Create Note
create-note
Creates a note in the configured notes provider.
Get Contents of URL
web-request
Runs a GET or POST request and passes along the response.
Open URL
open-url
Opens a URL in the default browser.
Get Device Details
device-details
Returns platform, architecture, and app environment details.
Show Notification
notification
Shows a local in-app notification.
Copy to Clipboard
copy-clipboard
Copies text (or the previous output) to the system clipboard.
Files
5Save File
save-file
Saves text output to a file (relative paths land in the vault).
Get Contents of Folder
list-folder
Lists files and folders from a directory (relative paths resolve in the vault).
Create Folder
create-folder
Creates a folder (relative paths land in the vault).
Make PDF
make-pdf
Converts supported text, HTML, or images into a PDF.
Get Text from PDF
extract-pdf-text
Extracts searchable text from a PDF.
Utilities
6Run Shortcut
run-shortcut
Calls another saved Zeshort shortcut.
Run Shell Script
run-shell-command
Runs a shell command (cmd on Windows, sh elsewhere) and passes along its output. Use {variable} to insert saved values.
Calculate
calculate
Evaluates a math expression — use {variable} to insert saved values.
Stop This Shortcut
stop-shortcut
Stops execution immediately.
Stop and Output
stop-output
Stops execution and returns the current value.
Summarize Text
summarize-text
Summarizes text using the configured AI provider.