> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Stella chat

> Open Stella over any page, find past chats, and use the composer: the + menu, commands, the model, dictation and queued messages.

## Overview

Stella, your AI teammate, opens over the page you're on, docked beside it, or on its own full page. Every chat is kept in your **Chats** list. This page covers where the chat lives and what each control in the composer does. For what to ask, see [What Stella can do](https://docs.custral.com/ai/tools/library.md).

![Right-click the Stella button for New chat, Dock to the side, Pop out and Chat history.](https://docs.custral.com/images/screens/ai/stella-menu-light.png)

Right-click the Stella button for New chat, Dock to the side, Pop out and Chat history.

## Open Stella

Click **Stella** in the top bar, or press **⌘I**. A new chat opens over the page. Press it again to close Stella.

Right-click the **Stella** button for the other ways in:

| Menu item | What it does |
| - | - |
| **New chat** (⌘N) | Starts a fresh chat on Stella's full page. |
| **Dock to the side** | Opens Stella as a panel on the right of the page. |
| **Pop out** (⌘I) | Floats Stella over the page. |
| **Chat history** | Opens your **Chats** list in the sidebar. |

**⌘⇧I** opens Stella with the page you're on already attached.

## Your chats

The **Chats** list in the sidebar holds every Stella chat you've had.

* **New chat** (⌘N) starts a chat on the full page. The **▾** beside it chooses who the chat is with: **Stella**, or one of your workspace's [chat agents](https://docs.custral.com/ai/chat-agents/overview.md). The same menu has **New agent…** (admins only), **New routine…** and **Manage agents**.
* Click a chat to open it on the full page. Its **⋯** menu has **Open in a window**, **Copy link**, **Rename**, **Mark done**, **Archive** and **Delete chat**.
* **Mark done** keeps a chat in the list with a check. **Archive** moves it to Archived.
* Select several chats to archive or delete them together.
* The search icon searches your chats from the command palette.
* A dot marks a chat with activity you haven't seen.

### The View menu

The sliders icon (**View**) sets what the list shows.

| Section | Options |
| - | - |
| **Show** | **Active**, **Unread** or **Archived**, each with its count |
| **Filter** | **Last activity** (Any time, Today, 7 days, 30 days, 90 days). **Agent** and **Model** appear when your chats use more than one. |
| **Sort by** | Most recent, Oldest, Title A–Z |
| **Group by** | Date, Agent, Model, None |

**Show → Unread** lists the chats with activity you haven't seen, with **Mark all as read** above them. A chat that a [routine](https://docs.custral.com/ai/routines/overview.md) delivers carries a repeat mark ("From routine: …") and arrives unread.

## The composer

![The + menu adds things to a message, or steers it.](https://docs.custral.com/images/screens/ai/composer-plus-menu-light.png)

The + menu adds things to a message, or steers it.

| Control | What it does |
| - | - |
| **+** (Add to message) | The menu below. |
| Mode | **Ask first** or **Auto**. ⇧Tab switches. See [Permissions](https://docs.custral.com/ai/permissions.md). |
| Agent | Shows only when the chat uses an agent. ⌘⇧P opens the list. |
| Model | The model this chat uses. ⌘⇧K opens the list. See [Models & Providers](https://docs.custral.com/ai/models/overview.md). |
| Mic (**Dictate**) | Press to talk, press again to stop. The words go into your message for you to check. Nothing sends on its own. |
| Send / **Stop** | Sends the message. While Stella is answering and the box is empty, the button is **Stop**. |

### The + menu

| Item | What it does |
| - | - |
| **Add files or photos** | Attaches images, PDF, text, Markdown, CSV or Word (.docx) files. |
| **Add a record…** | Pick a record to attach. |
| **Add this page** (⌘⇧I) | Attaches the page you're on. Greyed out once it's attached. |
| **Pick from the page** | Click a cell, row, paragraph or chart to attach just that. See [Inspect the page](https://docs.custral.com/ai/inspect.md). |
| **Connectors** | **Browse connectors**, **Manage connectors**, a switch for each of your connections, and a few you could still connect. Picking a connection puts its `/name` in front of your message, so Stella uses it first. See [Connectors](https://docs.custral.com/ai/mcp-connections.md). |
| **Commands** | Your workspace's `/commands`. Picking one puts it in front of your message. |
| **Agent: Default** | Who answers: **Default** (plain Stella) or one of your chat agents. |

### Commands

Type **/** in the message to see every command and connector you can use. Every workspace has these built-in commands:

| Command | What it does |
| - | - |
| `/meeting` | Find a time and book a meeting with someone |
| `/mail` | Draft an email for you to review |
| `/reply` | Draft a reply to the conversation you're on |
| `/task` | Create a task from what you type |
| `/note` | Add a note to the record you're on |
| `/prep` | Get a brief before your next meeting |
| `/summary` | Summarize the record or conversation you're on |
| `/today` | See today's meetings, due tasks, and emails waiting on you |
| `/find` | Search records, conversations, emails, and docs at once |
| `/booking-link` | Get a booking link to send to someone |
| `/health` | Check how an account is doing: usage, activity, and risks |

Write who or what it's about after the command, like `/prep Hooli`. With nothing after it, Stella uses what's attached, such as the record you're on, and asks if it still can't tell. A [skill](https://docs.custral.com/ai/rules-and-skills.md) your workspace saves with the same trigger replaces the built-in command.

### Queued messages

You can keep typing while Stella answers. A message you send then waits at the end of the chat, dashed and marked with a clock, and goes out when the reply finishes.

* **Send now** (the arrow) stops the reply and sends what's queued. Several queued messages go out together.
* **×** removes a message from the queue.

## Shortcuts

| Keys | Action |
| - | - |
| ⌘I | Open or close Stella over the page |
| ⌘⇧I | Open Stella with this page attached |
| ⌘N | New chat on the full page (desktop app) |
| ⌘⇧N | New chat in a new tab (desktop app) |
| ⌘⇧K | Open the model list |
| ⌘⇧P | Open the agent list |
| ⇧Tab | Switch between Ask first and Auto |
| Esc | Cancel **Pick from the page** |

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| The Chats list says "Showing 40 of …" | The default view (grouped by date, no filters) shows the 40 most recent chats | Click **Show all**, or filter or group the list. |
| "No chats match these filters." | A View filter hides them | Open **View** and choose **Clear filters**. |
| A chat I read still shows as unread on another computer | Unread is tracked separately in each browser and device | Open the chat there, or use **Mark all as read**. |
| **Add this page** is greyed out | The page is already attached | Look for its chip above the message. |
| An agent is missing from the agent list | The agent is switched off | An admin turns it back **On** under **Settings → AI and automations → Agents**. |
| **New agent…** is greyed out | "Only workspace admins can create, change or delete AI agents." | Ask an admin, or start a [routine](https://docs.custral.com/ai/routines/overview.md), which any member can make. |
| ⌘N opens a new browser window | Browsers keep ⌘N and ⌘⇧N for themselves | Use **New chat** in the Stella button's menu or the Chats list. |
| Stella stops and says you've used your AI credits | An admin's AI limit | See [AI access and limits](https://docs.custral.com/ai/access-and-limits.md). |

## Related

> [card] [What Stella can do](https://docs.custral.com/ai/tools/library.md)
>
> Example prompts for everything Stella can do.

> [card] [Inspect the page](https://docs.custral.com/ai/inspect.md)
>
> Point Stella at one cell, row or chart.

> [card] [Permissions](https://docs.custral.com/ai/permissions.md)
>
> Ask first, Auto, and "Always allow" rules.

> [card] [Stella memory](https://docs.custral.com/ai/memory.md)
>
> Facts Stella keeps between chats.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.