Custom Actions

Create your own actions to supercharge your workflow.

Creating a Custom Action

1. Open Preferences → Actions
2. Click the + button
3. Configure your action:
   • Title - Name displayed in tooltips
   • Icon - Built-in Phosphor icons, emojis, or imported PNG/GIF images
   • Type - Folder, URL, Shortcut, Shell Script, AppleScript, or Builtin
   • Template / Command - The URL template, script, or shortcut name
   • Context (Regex) - Optional regex to show action only for matching text
   • Shortcut - Keyboard shortcut to trigger the action

Action Types

URL

Opens a web page or deep link. Use {text} to include selected text.

Examples:

• https://google.com/search?q={text}
• raycast://extensions/search?query={text}
• obsidian://search?query={text}

See URL Actions for more details.

Shell Script

Runs a shell command (bash, zsh, etc.).

Example:

# Convert to uppercase and paste
printf '%s' "$ONTEXT_TEXT" | tr 'a-z' 'A-Z' | pbcopy && {paste}

Shell actions receive selected text and other user-controlled values through quoted ONTEXT_* environment variables. This keeps the value separate from the command itself.

See Shell Scripts for more details.

AppleScript

Runs AppleScript directly (no osascript -e needed).

See AppleScript for more details.

Shortcut

Runs a macOS Shortcut by name.

Examples:

• Add to Calendar
• Create Note

See Shortcuts Integration for more details.

Builtin

Built-in action templates:

Template	Description
COPY	Copy text to clipboard
COUNT	Count characters
LARGE_TYPE	Display in large type
CAMEL_CASE	Convert to camelCase
PASCAL_CASE	Convert to PascalCase
SNAKE_CASE	Convert to snake_case
KEBAB_CASE	Convert to kebab-case
CONSTANT_CASE	Convert to CONSTANT_CASE
DOT_CASE	Convert to dot.case
COPY_COLOR	Copy color value
BLANK	Empty space (for layout)
SEPARATOR	Visual separator `
SPELL_CHECK	Check spelling

Customizing Icons

Phosphor Icons

1. Click the icon in the action row
2. Browse the Phosphor Icons grid
3. Click to select

Custom Images

1. Click the icon in the action row
2. Click Import
3. Select an image file (PNG or GIF)

Emoji

1. Click the icon in the action row
2. Click the Emoji tab
3. Select the emoji you want to use
4. Click Use this emoji

Managing Actions

Reorder

Drag and drop actions in the list to change their order.

Enable/Disable

Click the checkbox to show/hide an action from the floating panel.

Delete

Select an action and click the - button, or press Delete.