Commands

Commands let you save prompts you use often. Instead of typing the same request again and again, you can save it once and run it whenever you need it.

For example, you might save commands for:

  • Rewriting selected text
  • Turning notes into an email
  • Summarizing the current page
  • Translating copy
  • Cleaning up voice notes

Use A Command

Type / in the command bar to see your saved commands.

  • Keep typing to filter the list
  • Use the arrow keys to choose one
  • Press Enter to run it

You can also give a command its own keyboard shortcut.

Create A Command

  1. Open Settings → Commands.
  2. Click +.
  3. Give it a short name, such as “Fix Grammar” or “Summarize”.
  4. Write the prompt you want Atua to use.
  5. Choose an output mode (see below).
  6. If you want, assign a keyboard shortcut.

Share Commands

You can export one command or several commands as a JSON bundle and share that file with someone else.

To export:

  1. Open Settings → Commands.
  2. Click the Export button in the sidebar.
  3. Choose one or more commands.
  4. Save the JSON file.

To import:

  1. Open Settings → Commands.
  2. Click the Import button in the sidebar.
  3. Pick a previously exported JSON file.
  4. Review the commands and any MCP servers they depend on.
  5. Click Import.

If an imported command depends on MCP tools from a server you do not already have, Atua shows that server in the import review and asks whether you want to install it. If you install it, Atua also enables the specific MCP tools that the imported command needs.

Shared command bundles include:

  • Command name
  • Prompt
  • Output mode
  • Per-command model settings
  • Tool access settings
  • MCP server definitions needed for the selected MCP tools

Shared command bundles do not include:

  • API keys
  • OAuth tokens
  • Client secrets
  • Custom header secrets
  • Local environment secrets

That means the person importing the file may still need to finish authentication for a remote MCP server such as Notion.

Context tags

Context tags are placeholders that pull in what you are already working on. Add them to your prompt using double curly braces, like {{selectedText}}.

Quick reference

TagWhat it capturesCaptured when
selectedTextThe text you have highlightedWhen the command bar or command hotkey is triggered
appContextThe app you came from, plus the window title or browser URL when availableWhen the command runs
clipboardContentWhatever text is currently on your clipboardWhen the command runs
currentDateToday’s date and timeCommand runs
screenshotA screenshot of the active windowIncluded only when used
ocrText read from the screenCommand runs
windowContentThe full content of the current page or windowCommand runs
transcriptVoice input recorded and transcribed on-deviceCommand runs (prompts you to speak)

selectedText

Use this when you want Atua to work on the exact text you selected.

Example prompts:

Translate {{selectedText}} to Spanish. Keep the original formatting.

Rewrite {{selectedText}} to be more concise and professional.

appContext

Use this when the current app or page matters.

{{appContext}} gives Atua extra clues about where you came from.

Depending on the app, it can include:

  • The app name
  • The window title
  • The current browser URL

This is useful when you want Atua to understand not just the text, but the place it came from. For example, a page in Safari, a draft in Mail, or a document in Notion can all call for different output.

Example prompts:

Rewrite {{selectedText}} to match the tone implied by {{appContext}}.

You are assisting the user in this context: {{appContext}}. Adapt your response accordingly.

Save this page as a bookmark. Use {{appContext}} to capture the source and {{windowContent}} to understand the page.

clipboardContent

Use this when you copied something and want to bring it into the prompt without selecting it again.

Example prompts:

Compare {{selectedText}} with {{clipboardContent}} and highlight the differences.

Use {{clipboardContent}} as reference material to answer this question: {{selectedText}}

currentDate

Use this for anything time-sensitive.

Example prompts:

Draft a follow-up email. Reference that today is {{currentDate}} and the deadline is in 3 days.

screenshot

Use this when the visual layout matters, such as a chart, a UI, or an error message on screen.

Example prompts:

Describe what you see in {{screenshot}} and suggest improvements to the UI.

Draft a reply to the email shown in {{screenshot}} using {{selectedText}} as key points.

What error is shown in {{screenshot}}? How do I fix it?

ocr

Use this when the text is visible on screen but you cannot select it, such as a PDF, image, scanned page, or screenshot.

Example prompts:

Extract the total amount, date, and vendor from {{ocr}} and format as JSON.

Summarize the article text from {{ocr}} into 3 bullet points.

Translate all text from {{ocr}} to English.

windowContent

Use this when you want Atua to read the whole page or window instead of just the selected text.

Example prompts:

Summarize the content of this page using {{windowContent}} into 3 bullet points.

List all links and their destinations from {{windowContent}}.

What are the main topics covered on this page? Use {{windowContent}} to answer.

Extract all product names and prices from {{windowContent}} and format as a table.

transcript

Use this when speaking is faster than typing.

Example prompts:

Turn {{transcript}} into a meeting summary with action items and owners.

Clean up {{transcript}} into a well-structured email.

Convert these voice notes into a bullet-point list: {{transcript}}

Choosing the right tag

Use {{selectedText}} when you already highlighted what matters.

Use {{windowContent}} when you want Atua to read the whole page or window.

Use {{ocr}} when text is visible but not selectable.

Use {{screenshot}} when the look of the screen matters.

Use {{transcript}} when you want to speak instead of type.

Use {{appContext}} when the current app or page matters.

Writing prompts

You can combine tags in one prompt. A simple pattern that works well is:

  1. Tell Atua what to work on
  2. Tell it what you want back
  3. Add any useful tags

Examples:

Summarize {{windowContent}} in 5 bullet points.

Rewrite {{selectedText}} for a customer email in {{appContext}}.

Turn {{transcript}} into meeting notes with action items.

Real-World Command Examples

These examples are a good starting point. You can save them as commands and adjust the wording to fit how you work.

Fix Grammar

Good for: cleaning up selected writing before you paste it back

Prompt:

Fix grammar, spelling, and punctuation in {{selectedText}}. Keep the original meaning and tone. Return only the corrected version.

Best output mode: Replace Selected Text

Reply In My Tone

Good for: drafting a response to an email, message, or comment

Prompt:

Draft a reply to {{selectedText}}. Use {{appContext}} to match the setting and tone. Keep it clear, friendly, and ready to send.

Best output mode: Show in Chat

Summarize This Page

Good for: articles, docs, or long internal pages

Prompt:

Summarize {{windowContent}} into 5 short bullet points. End with one sentence that explains why this page matters.

Best output mode: Show in Chat

Turn Voice Notes Into Tasks

Good for: spoken planning, meeting notes, or quick brain dumps

Prompt:

Turn {{transcript}} into a short task list. Group related items together, keep the wording practical, and flag anything that sounds like a follow-up.

Best output mode: Show in Chat

Create Reminders From Voice Notes

If you have the Reminders tool enabled, you can go one step further.

Prompt:

Read {{transcript}}, extract clear action items, and create reminders for them with the Reminders tool. Use short reminder titles and include due dates only when they are clearly mentioned.

Best output mode: Run in Background

Triage A Bug Report

Good for: bug reports, support messages, or copied error notes

Prompt:

Analyze {{selectedText}} and turn it into a structured bug summary with: issue, likely cause, steps to reproduce, user impact, and next action.

Best output mode: Show in Chat

Example Command: Bookmark To Notion

If you have the Notion MCP server connected, you can make a command that saves the page you are viewing directly to a Notion database.

Name: Bookmark to Notion

Prompt:

Look at the page I’m on. Use {{appContext}} to capture the source and URL. Use {{windowContent}} to understand what the page is about. Write a short summary, pick a few relevant tags, and save it to my bookmarks database in Notion. The database ID is d3155ef96c584bf090e1d8b1a7ee8940.

This works well in browsers because {{appContext}} includes the page URL and {{windowContent}} gives Atua the full page content. The Notion MCP server handles authorization through OAuth, so there are no API keys to manage.

Output modes

Each command can send the result somewhere different:

  • Show in Chat keeps the result in the command bar so you can review it first.
  • Replace Selected Text pastes the result over the text you selected.
  • Run in Background runs the command quietly, shows a small status bubble, and lets you check the result later in chat history.

Add A Shortcut

You can give a command its own keyboard shortcut. Select text in any app, press the shortcut, and run the command right away.

Set this up in Settings → Commands.

Choose A Different Model For One Command

Each command can use its own provider and model. This is useful if you want a fast model for quick edits and a stronger model for bigger tasks.

You can also adjust things like creativity and response length for each command.

Notes About Imported Commands

When you import commands:

  • Atua keeps the prompt and command settings
  • Imported commands are added as new commands instead of replacing existing ones
  • If a name already exists, Atua gives the imported copy a unique name
  • If the bundle includes MCP server dependencies, Atua can add those servers for you during import