Docs

RunMacro Documentation

Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

🤖 AI

Process text with AI in RunMacro

AI Integration sends text from a variable or clipboard with a prompt to your configured AI provider, then stores the reply in a variable or clipboard. A provider must be enabled in Settings first.

Prerequisites

At least one AI provider enabled in Settings (API key + model).
Internet access to call the API.
Input text available in a variable or the clipboard.

Supported modes

Desktop Mode — Runs in both Desktop and Browser modes.
Browser Mode

What it does

The AI Integration command takes input text (from a variable or the clipboard), combines it with the prompt you write, sends it to the AI provider you configured in Settings, then saves the reply to a variable or clipboard. Use it to summarize, rewrite, translate, classify, or extract content inside a workflow.

When to use it

Summarize or rewrite a piece of collected text.
Translate content to another language between steps.
Classify or label data, then branch on the result.
Generate short content within a min/max word limit.

When not to use it

You do not want to send data to an external service.
No AI provider can be configured.
You need 100% deterministic output — AI replies can vary between runs.

Configuration steps

Open Settings › AI and enable at least one provider (enter an API key + pick a model).
Add an AI › AI Integration command.
Choose the Input source: Variable or Clipboard. For a variable, enter its name.
Write a Prompt describing the task (you can insert variables inside it).
Choose the Output target: save to a variable (enter a name) or the clipboard.
(Optional) Set min/max words to bound the length. Save and test.

Every option explained

Input source (Variable / Clipboard)

Choose whether the AI input text comes from a variable or the current clipboard.

Input variable

Name of the variable holding the text to process (used when the source is Variable).

Prompt

Instruction describing what the AI should do. The input text is appended after it. You can insert variables with {name}.

Provider

Leave empty to use the default provider from Settings, or pick a specific provider.

Output target (Variable / Clipboard)

Where the AI reply is saved: a variable (enter a name) or the clipboard.

Min / max words

Bound the reply length. 0 means no limit. Minimum cannot exceed maximum.

Expected result

RunMacro calls the AI provider and stores the returned text in the chosen variable or clipboard; it logs the number of characters received.

Real example

Example: summarize clipboard content

Copy a block of text (or use Copy Text to grab it into the clipboard).
AI Integration: Source = Clipboard, Prompt = "Summarize the following briefly".
Output target = variable summary, Max words = 60.
Use {summary} in later steps.

Limitations and failure cases

Depends on an external service: needs a valid API key and stable network.
A per-command model does not override the model configured in Settings.
Results may differ between runs.

Tips & common mistakes

You must configure an AI provider (API key + model) in Settings before the command can run. If it is not ready, the command logs a reason and returns failure.

Prompt text and input data are sent to an external AI provider. Do not send sensitive data if your policy disallows it.

Verification details

commands/ai.py