> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Using Craft Assistant
> Learn how to start conversations and work with the Assistant to understand and transform your content.
Craft Assistant helps you understand and work with your content using natural language. You can ask questions, summarize documents, explore information across your Space, and, on supported platforms, edit documents directly.
## Where Craft Assistant is available
Craft Assistant works across all major platforms:
Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
Available at **space-level and document-level** on iPad and iPhone. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
## Start a conversation
Open a document or stay in your Space view.
Open the Assistant panel.
Choose a model and mode, then type your prompt.
Review the response or applied changes.
## Sessions
Craft Assistant sessions are designed for continuity:
* Sessions **sync across your devices**.
* Sessions pause after **5 minutes** of inactivity. Your conversation history is preserved.
* You can reopen **previous sessions** from the list.
* You can run **parallel sessions**.
* A **notification dot** appears when a background session completes.
## Editing your documents
On macOS and iOS, use **Execute** mode to apply changes directly. Use **Explore** mode when you want to review proposed changes first.
* **Explore** — proposes changes and waits for your approval before modifying anything.
* **Execute** — applies changes directly.
You can undo the full last Assistant action with **⌘Z (Ctrl+Z)**.
For full editing details, see [Editing with Craft Assistant](/en/ai-assistant/editing).
Full editing support at document-level and space-level.
Full editing support at document-level and space-level on iPad and iPhone.
Assistant available, Execute mode coming later.
Assistant available, Execute mode coming later.
## Example questions you can ask
**Understanding your content:**
* "What did I write about this topic last year?"
* "What tasks are still open for Project Y?"
* "Summarize all notes related to onboarding new hires."
**Working with specific content:**
* "Summarize this document in 3 bullet points"
* "Extract all action items from this meeting note"
* "What are the key decisions mentioned here?"
**Editing:**
* "Add a summary callout at the top of this document"
* "Restyle the headings with colors and add dividers"
* "Break this into subpages, one per section"
* "Create a new document with meeting notes from this page"
**Space-level queries:**
* "Find all documents about marketing campaigns"
* "What deadlines do I have this week?"
* "Show me everything related to the Q4 project"
The Assistant can understand Collections, including properties and relationships.
## Privacy and your data
Craft Assistant is designed with privacy first:
* Sessions sync across your devices for continuity.
* Craft does not use your content to train AI models.
* Only the minimum data required to process a request is sent to the model provider.
* Token usage and cost are recorded for usage tracking.
For details on AI usage, see [Usage & Limits](/en/ai-assistant/usage).
## Choosing a model
The model you select changes speed, capability, and AI usage:
* **Core:** Everyday in-document queries. Uses a low amount of AI usage. Read-only.
* **Fast:** Good for space-level questions and supports editing.
* **Max:** Best for complex reasoning and editing quality.
* **Local:** On-device models (Apple Foundation Model, LLaMa 3.2) that run locally on your device. Always free. Read-only.
Only **Fast** and **Max** support editing.
See [Choosing the right AI model](/en/ai-assistant/models) for details.
## Preferences
Preferences let you give the Assistant background information that applies to every conversation. Unlike custom prompts, which you select per task, preferences are always active regardless of which model or provider you use.
Use preferences for things like your preferred language, tone, response length, or role context.
### Add a preference
Go to **Settings** > **Assistant**.
Scroll to the **Preferences** section.
Tap **Add Preference**, type your instruction, and tap **Add**.
### Example preferences
* "Use British English spelling"
* "Keep responses under 3 paragraphs"
* "I work in marketing. Use brand-friendly language"
* "Always respond in Spanish"
* "When summarizing meetings, always extract action items with owners"
### Manage preferences
To edit or delete a preference, tap the **3-dots button** next to it and choose **Edit** or **Delete**.
## Disable the Assistant
You can turn the Assistant off per Space:
Open Space settings.
Turn off the Assistant toggle.
This setting is not synced across devices or users. If you disable it on one device, it remains enabled on others until changed there too.
## Related Articles
Select the right model for your task and editing needs
Let the Assistant make changes directly in your documents
Create reusable instructions for consistent results
Use OCR to extract text and generate descriptions
Get instant help about Craft features without leaving the app
## Where Craft Assistant is available
Craft Assistant works across all major platforms:
## Sessions
Craft Assistant sessions are designed for continuity:
* Sessions **sync across your devices**.
* Sessions pause after **5 minutes** of inactivity. Your conversation history is preserved.
* You can reopen **previous sessions** from the list.
* You can run **parallel sessions**.
* A **notification dot** appears when a background session completes.
## Editing your documents
On macOS and iOS, use **Execute** mode to apply changes directly. Use **Explore** mode when you want to review proposed changes first.
* **Explore** — proposes changes and waits for your approval before modifying anything.
* **Execute** — applies changes directly.
You can undo the full last Assistant action with **⌘Z (Ctrl+Z)**.
For full editing details, see [Editing with Craft Assistant](/en/ai-assistant/editing).
### Example preferences
* "Use British English spelling"
* "Keep responses under 3 paragraphs"
* "I work in marketing. Use brand-friendly language"
* "Always respond in Spanish"
* "When summarizing meetings, always extract action items with owners"
### Manage preferences
To edit or delete a preference, tap the **3-dots button** next to it and choose **Edit** or **Delete**.
## Disable the Assistant
You can turn the Assistant off per Space: