Spark

Spark

Spark is the layer that transforms text after transcription.

Think of it as: "take this text + this instruction + this model -> return improved text."

You can use Spark for:

• cleanup and punctuation
• rewrite tone/style
• summarize long text
• convert notes into structured output

Core Toggles

• Enable Spark
• Clipboard Context
• Screen Context

Context toggles add extra information to prompts.

• Clipboard Context: includes current clipboard text
• Screen Context: includes visible context from the active screen

Use context intentionally; more context is not always better.

Prompt Management (The Important Part)

Use Spark Prompt cards to:

• select active prompt
• add/edit prompts
• enable/disable prompts
• reorder prompts via drag-and-drop
• delete prompts

Prompt Fields

Each prompt supports:

• title
• icon (SF Symbol)
• description
• system prompt text
• trigger words

Practical Prompt Writing Formula

1. Role: who the model should act as.
2. Task: exactly what to do.
3. Output rules: strict format constraints.
4. Guardrails: what not to change.

Example constraints that help:

• "Do not invent facts."
• "Keep names, numbers, and product terms unchanged."
• "Return plain text only."

Selected Text Modes

Configure default behavior for:

• Popup Mode
• In-Place Mode

Each mode has:

• prompt
• provider
• model

Use Popup Mode when you want review before replace.

Use In-Place Mode when speed matters and the prompt is trusted.

Spark Palette Defaults

For mouse-selection Spark Palette flows, configure provider/model for:

• Popup / Read-Only
• In-Place

Prompt comes from the clicked palette action.

Conversation Popup Session Overrides

When launched from Open Conversation Popup shortcut (App Shortcuts):

• you can choose Spark prompt inside the popup (No Spark Prompt is supported)
• you can choose model inside the popup for that session
• selected prompt/model apply to follow-up requests from that popup session
• these overrides do not change your global Spark defaults

Provider Configuration

Spark supports multiple providers, including cloud and local-network backends.

Common controls:

• provider selection
• model selection
• refresh model list
• API key save/remove

Provider-specific controls:

• Ollama: base URL, model list, connection check
• LM Studio: base URL, model list, connection check
• Llama.cpp: endpoint + model + API key
• Custom: multiple named profiles with endpoint/model/API key

Airplane Mode

When Airplane Mode is enabled, Spark can only use local-network endpoints.

Cloud providers are blocked.

Real Workflows

Dictation Cleanup

• prompt target: punctuation + paragraph cleanup
• mode: In-Place
• context: usually off

Email Rewrite

• prompt target: concise professional tone
• mode: Popup first, then apply
• context: screen context on if conversation context matters

Meeting Summary

• prompt target: decisions + action items + owners
• mode: Popup
• context: clipboard on when source notes are copied text