Zeshort Logo
Zeshort Action Reference
← Back to home

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

14

Show Result

show-result
headless

Displays the current output in the runner.

in: any out: text

Ask for Input

ask-input
headless

Prompts the user for text, a number, or a URL.

in: none out: text

Show Alert

alert
headless

Displays a modal message that needs acknowledgement.

in: none out: none

Comment

comment
headless

Adds a note that does not run.

in: none out: none

Set Variable

set-variable
headless

Stores a value under a reusable name — leave the parameter empty to capture the previous output. Reference it later as {name}.

in: any out: none

Get Variable

get-variable
headless

Reads a value saved earlier in the shortcut.

in: none out: text

If

if
needs UI / provider

Runs a branch only when a condition matches. Needs nested steps — not executable yet.

in: any out: none

Repeat

repeat
needs UI / provider

Repeats the nested actions a fixed number of times. Needs nested steps — not executable yet.

in: none out: none

Repeat with Each

repeat-each
needs UI / provider

Runs the nested actions once for each item in a list. Needs nested steps — not executable yet.

in: list out: none

Choose from Menu

choose-menu
needs UI / provider

Presents named options and continues from the selected option.

in: none out: text

Choose from List

choose-list
needs UI / provider

Lets the user select one or more items from a list.

in: list out: text

Get Item from List

get-list-item
headless

Gets the first, last, random, or indexed item from the previous output.

in: list out: text

Count

count
headless

Counts items, characters, words, or lines.

in: any out: number

Wait

wait
headless

Pauses execution for a number of seconds.

in: none out: none
📝

Text

9

Text

text
headless

Provides plain text to the next action.

in: none out: text

Get Text from Input

get-text
headless

Extracts readable text from the current input.

in: any out: text

Combine Text

combine-text
headless

Joins a list of text values with a separator.

in: list out: text

Replace Text

replace-text
headless

Finds and replaces text in the previous output.

in: text out: text

Split Text

split
headless

Divides text into a list by lines, spaces, commas, or custom text.

in: text out: list

Change Case

change-case
headless

Converts text to uppercase, lowercase, or title case.

in: text out: text

Trim Whitespace

trim-whitespace
headless

Removes extra spaces and blank lines from text.

in: text out: text

Speak Text

speak
headless

Reads text aloud using the system speech engine when available.

in: text out: none

Translate Text

translate-text
needs UI / provider

Translates text through the configured translation provider.

in: text out: text
🧠

OpenAI

8

OpenAI Text Response

openai-response
headless

Calls the OpenAI Responses endpoint with a prompt and optional previous output.

in: text out: text

OpenAI Vision

openai-vision
needs UI / provider

Analyzes an image URL or file reference through a vision-capable OpenAI model.

in: any out: text

OpenAI Text to Speech

openai-tts
needs UI / provider

Generates speech audio from text through the OpenAI audio speech endpoint.

in: text out: audio

OpenAI Transcribe Audio

openai-transcribe
needs UI / provider

Transcribes an audio file through the OpenAI audio transcription endpoint.

in: any out: text

OpenAI Translate Audio

openai-translate-audio
needs UI / provider

Translates an audio file into English through the OpenAI audio translations endpoint.

in: any out: text

OpenAI Image Generation

openai-image
needs UI / provider

Creates an image from a prompt through the OpenAI image generation endpoint.

in: text out: image

OpenAI Embedding

openai-embedding
needs UI / provider

Creates vector embeddings from text through the OpenAI embeddings endpoint.

in: text out: text

OpenAI Custom Endpoint

openai-custom
needs UI / provider

Prepares a custom OpenAI API call with an endpoint path and JSON body.

in: any out: text
🦙

Zallama

3

Zallama Text Response

zallama-response
headless

Calls a local Zallama (OpenAI-compatible) server with a prompt and optional previous output.

in: text out: text

Zallama Chat

zallama-chat
headless

Sends a system prompt and user message to a local Zallama (OpenAI-compatible) chat endpoint.

in: text out: text

Zallama Embedding

zallama-embedding
needs UI / provider

Creates vector embeddings from text through a local Zallama (OpenAI-compatible) embeddings endpoint.

in: text out: text
🎬

Media

7

Find Media

find-media
needs UI / provider

Searches images, videos, or audio from a selected folder or library.

in: none out: list

Get Latest Media

get-latest-media
needs UI / provider

Gets the most recent images, videos, or audio items.

in: none out: list

Save Media

save-media
needs UI / provider

Saves generated or selected media to a folder.

in: list out: none

Resize Image

resize-image
needs UI / provider

Resizes an image to a target width, height, or percentage.

in: any out: any

Crop Image

crop-image
needs UI / provider

Crops an image to a rectangle or aspect ratio.

in: any out: any

Play Audio

play-audio
needs UI / provider

Plays an audio file or stream.

in: text out: none

Transcribe Audio

transcribe-audio
needs UI / provider

Turns speech in an audio file into text.

in: any out: text
🌐

Apps

10

Send Email

send-email
headless

Opens the default mail client with recipient, subject, and body prefilled.

in: none out: none

Add Calendar Event

add-calendar-event
needs UI / provider

Creates a calendar event through a configured calendar provider.

in: none out: none

Add Reminder

add-reminder
needs UI / provider

Creates a task in the configured reminders provider.

in: none out: none

Open App

open-app
needs UI / provider

Launches an installed app by name or path.

in: none out: none

Create Note

create-note
needs UI / provider

Creates a note in the configured notes provider.

in: none out: none

Get Contents of URL

web-request
headless

Runs a GET or POST request and passes along the response.

in: none out: text

Open URL

open-url
headless

Opens a URL in the default browser.

in: text out: none

Get Device Details

device-details
headless

Returns platform, architecture, and app environment details.

in: none out: text

Show Notification

notification
needs UI / provider

Shows a local in-app notification.

in: none out: none

Copy to Clipboard

copy-clipboard
headless

Copies text (or the previous output) to the system clipboard.

in: text out: none
📂

Files

5

Save File

save-file
headless

Saves text output to a file (relative paths land in the vault).

in: text out: none

Get Contents of Folder

list-folder
headless

Lists files and folders from a directory (relative paths resolve in the vault).

in: none out: list

Create Folder

create-folder
headless

Creates a folder (relative paths land in the vault).

in: none out: none

Make PDF

make-pdf
needs UI / provider

Converts supported text, HTML, or images into a PDF.

in: text out: none

Get Text from PDF

extract-pdf-text
needs UI / provider

Extracts searchable text from a PDF.

in: any out: text
🔧

Utilities

6

Run Shortcut

run-shortcut
headless

Calls another saved Zeshort shortcut.

in: none out: text

Run Shell Script

run-shell-command
headless

Runs a shell command (cmd on Windows, sh elsewhere) and passes along its output. Use {variable} to insert saved values.

in: text out: text

Calculate

calculate
headless

Evaluates a math expression — use {variable} to insert saved values.

in: text out: number

Stop This Shortcut

stop-shortcut
headless

Stops execution immediately.

in: none out: none

Stop and Output

stop-output
headless

Stops execution and returns the current value.

in: any out: text

Summarize Text

summarize-text
needs UI / provider

Summarizes text using the configured AI provider.

in: text out: text