> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/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.

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/ai-assistant/using/en/content/assistant-interface.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=c9647eefaea822f38e79503350d83b28" alt="Craft Assistant interface showing conversation panel" width="209" height="142" data-path="images/ai-assistant/using/en/content/assistant-interface.png" />

## Where Craft Assistant is available

Craft Assistant works across all major platforms:

<Tabs>
  <Tab title="macOS">
    Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
  </Tab>

  <Tab title="iOS">
    Available at **space-level and document-level** on iPad and iPhone. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
  </Tab>

  <Tab title="Windows">
    Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
  </Tab>

  <Tab title="Web">
    Available at **space-level and document-level**. Works in Documents, Tasks, Calendar, Collections, Code Editor, and browse views.
  </Tab>
</Tabs>

## Start a conversation

<Steps>
  <Step>
    Open a document or stay in your Space view.
  </Step>

  <Step>
    Open the Assistant panel.
  </Step>

  <Step>
    Choose a model and mode, then type your prompt.
  </Step>

  <Step>
    Review the response or applied changes.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/ai-assistant/using/en/content/assistant-prompt.png?s=db4cfe1c95f55a14f01ac4ecdf862da3" alt="Assistant showing example prompt and response" width="800" height="476" data-path="images/ai-assistant/using/en/content/assistant-prompt.png" />

## Sessions

Craft Assistant sessions are designed for continuity:

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/using/en/content/assistant-sessions.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=25b9e314a988f246b89800bd1a115482" alt="Conversation History showing past sessions" width="1568" height="943" data-path="images/ai-assistant/using/en/content/assistant-sessions.png" />

* 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).

<Tabs>
  <Tab title="macOS">
    Full editing support at document-level and space-level.
  </Tab>

  <Tab title="iOS">
    Full editing support at document-level and space-level on iPad and iPhone.
  </Tab>

  <Tab title="Windows">
    Assistant available, Execute mode coming later.
  </Tab>

  <Tab title="Web">
    Assistant available, Execute mode coming later.
  </Tab>
</Tabs>

## 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"

<Info title="Collections Support">
  The Assistant can understand Collections, including properties and relationships.
</Info>

## 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. Includes cloud (GPT-5 Nano) and on-device options (Apple Foundation Model, LLaMa 3.2). Read-only.
* **Fast:** Good for space-level questions and supports editing.
* **Max:** Best for complex reasoning and editing quality.

Only **Fast** and **Max** support editing.

See [Choosing the right AI model](/en/ai-assistant/models) for details.

## Disable the Assistant

You can turn the Assistant off per Space:

<Steps>
  <Step>
    Open Space settings.
  </Step>

  <Step>
    Turn off the Assistant toggle.
  </Step>
</Steps>

<Warning title="Device-Specific Setting">
  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.
</Warning>

## Related Articles

<CardGroup cols={2}>
  <Card title="Choosing AI Models" href="/en/ai-assistant/models">
    Select the right model for your task and editing needs
  </Card>

  <Card title="Editing with Craft Assistant" href="/en/ai-assistant/editing">
    Let the Assistant make changes directly in your documents
  </Card>

  <Card title="Custom Prompts" href="/en/ai-assistant/custom-prompts">
    Create reusable instructions for consistent results
  </Card>

  <Card title="Image and PDF Support" href="/en/ai-assistant/ocr-images-pdfs">
    Use OCR to extract text and generate descriptions
  </Card>

  <Card title="Help Agent" href="/en/ai-assistant/help-agent">
    Get instant help about Craft features without leaving the app
  </Card>
</CardGroup>