> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vowen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows & Utilities

> Voice-triggered automations and AI-powered utilities.

<div style={{ marginTop: "-2.5rem" }}>
  <Info>Free plan includes built-in workflows plus 3 custom workflows and 1 preconfigured Custom Utility. <a href="https://vowen.ai" className="font-semibold underline-offset-2" style={{ color: "#8b5cf6", backgroundColor: "rgba(139, 92, 246, 0.12)", border: "1px solid rgba(139, 92, 246, 0.35)", padding: "2px 8px", borderRadius: "6px", fontSize: "0.85em", textDecoration: "none", whiteSpace: "nowrap" }}>Pro</a> unlocks unlimited workflows, unlimited Custom Utilities, and webhook / custom-script steps.</Info>
</div>

## Workflows

Workflows are voice-triggered actions. Speak a command while in transcription mode, and Vowen executes an action instead of pasting text.

### Built-in Workflows

| Trigger Phrase          | Action                              |
| ----------------------- | ----------------------------------- |
| "Search Google for..."  | Opens Google search with your query |
| "Search YouTube for..." | Opens YouTube search                |
| "Open ChatGPT..."       | Opens ChatGPT with your prompt      |

### How Workflow Triggers Work

Vowen matches your transcribed speech against configured workflow triggers using:

1. Exact prefix matching
2. Known aliases (e.g., "Google" matches "Search Google")
3. Fuzzy matching (75% similarity threshold)

The text after the trigger phrase becomes the query/input for the workflow action.

### Workflow Step Types

Built-in workflows ship with safe action types (open URL, search). When you build your own, the free plan supports up to 3 workflows using those same standard actions. Pro additionally unlocks:

* **Webhook** — POST your transcript to any HTTP endpoint
* **Custom script** — run a shell command with the transcript as input

## Custom Utilities <a href="https://vowen.ai" className="font-semibold" style={{ color: "#8b5cf6", backgroundColor: "rgba(139, 92, 246, 0.12)", border: "1px solid rgba(139, 92, 246, 0.35)", padding: "2px 8px", borderRadius: "6px", fontSize: "0.5em", textDecoration: "none", whiteSpace: "nowrap", verticalAlign: "middle", marginLeft: "0.5rem" }}>Pro plan</a>

Custom Utilities are shortcut-triggered AI prompts that don't require voice recording. They gather context (selected text, clipboard) and send it to your AI provider.

### Creating a Custom Utility

1. Open the Vowen app and click **Workflows** in the left sidebar
2. Switch to the **Custom Utilities** tab
3. Click **+ Create New**
4. Configure:
   * **Name:** what it's called
   * **Shortcut:** keyboard shortcut to trigger it
   * **Prompt:** the AI instruction (supports template variables)
   * **Output:** paste result or show notification

### Template Variables

Use these in your prompt to include dynamic context:

| Variable            | Value                              |
| ------------------- | ---------------------------------- |
| `{{selected_text}}` | Currently selected text in any app |
| `{{clipboard}}`     | Current clipboard contents         |

### Example Custom Utilities

**Proofread Selection:**

* Shortcut: `Ctrl + Shift + P`
* Prompt: `Proofread and fix any errors in this text, preserving the original meaning: {{selected_text}}`
* Output: Paste (replaces selected text)

**Summarize Clipboard:**

* Shortcut: `Ctrl + Shift + S`
* Prompt: `Summarize this in 3 bullet points: {{clipboard}}`
* Output: Paste

**Translate Selection:**

* Shortcut: `Ctrl + Shift + T`
* Prompt: `Translate this to Spanish: {{selected_text}}`
* Output: Paste

### Validation

If your prompt uses `{{selected_text}}` but nothing is selected when you trigger the utility, Vowen will warn you before proceeding.

### Requirements

* An AI provider must be connected
* Custom Utilities have a 500ms debounce to prevent accidental double-triggers