# Bots and chats

Each bot is a teammate with one continuous chat, its own instructions and memory, and a computer to
work on.

## Create a bot

Your first bot is created for you when you sign up. To add another, choose **Create** (the **+** at
the top of the sidebar), then **New bot**. If you have more than one [space](/docs/spaces/), pick the
space it goes in. Give it a name and choose **Create**.

Then tell it its job in the chat, in plain words. It asks for anything else it needs, such as a
sign-in or an app to connect.

> [!TIP]
> One bot per job works best: an inbox bot, a research bot, a bot for one client. Each keeps its own
> history and memory, so it gets better at that job over time.

## Talk to it

Type in the composer and press Enter. While a bot works, a short line such as **Working…** shows
it's busy. You can keep chatting meanwhile, and **Stop** ends the current run.

- **Attach file** adds files and images. If the bot's model can't read images, you can still
  send the picture as a file for the bot to work with.
- Type **@** to mention another bot, a group, a routine or a connected app.
- Type **/** at the start of a message to use a [skill](/docs/skills/).
- Hover a message to **React**, **Reply** or **Copy**. Select text in a reply to quote just that
  part.
- Hold the microphone to talk instead of typing. See [Voice and calls](/docs/voice-and-calls/).

Bots reply with formatted text, tables, charts and files. Files they send open in a preview and can
be downloaded. Every file a bot has sent is also listed in [**Library**](#find-things).

When you ask a bot to find something to buy, it can show the products as cards with photos, price
and rating. Open one for details, and **View on** the shop's site to go there.

To see which tools a bot used in a reply, turn on **Show tool activity** in **Settings → General**
under **Advanced**, on web and the desktop app.

When a bot needs something from you, it posts a card in the chat: a question, an
[approval](/docs/approvals/), or a request to take over its screen. Cards never block the chat; you
can answer later. A bot you send to a [meeting](/docs/meetings/#follow-it-in-the-chat) posts a card
that follows the meeting.

## Bot settings

Click the bot's name at the top of the chat, or choose **Edit Profile** from its menu in the
sidebar, to open its settings. Change the **Name** and avatar at the top: pick a shape and color,
or upload an image. The settings have four tabs:

- **Activity**: its [upcoming meetings](/docs/meetings/#upcoming-meetings) and
  [**Join my meetings**](/docs/meetings/#join-my-meetings), a live preview of the
  bot's [computer](/docs/computer/), and **Voice**: **Read replies aloud** and the bot's voice.
  **Suggested** offers **Create a routine** while it has none, and **Add to a meeting** until
  you've sent it to a meeting.
- **Library**: the files and [pages](/docs/pages/) the bot has made.
- **Routines**: its [routines](/docs/routines/).
- **Advanced**:
  - **Notifications**: **When it finishes or needs input**.
  - **Open work**: the to-do list the bot keeps for itself. You can add, complete or remove items.
  - **Memory**: what the bot has written down. See [Memory](/docs/memory/).
  - **Model** and **Thinking**: override the [model](/docs/models/) for this bot.
  - **Computer**: **Team** or **Private**. See [The bot's computer](/docs/computer/).
  - **Permissions**: **Allow cross-space bot communication**,
    [**Manage the bots it creates**](/docs/fleet-management/), and **Suggest work** on your
    [primary bot](/docs/primary-bot/).
  - **Instructions**: the bot's standing instructions. **Instruction history** lets you restore an
    earlier version. See [Write good instructions](/docs/writing-instructions/).
  - **How other bots see it**: a short description other bots read when deciding whom to ask.
  - **Tools**: **Disable a tool** the bot should never use.
  - **Export** downloads the bot's setup, memory, routines, files and its whole chat history as a
    file. **Clear conversation** empties the chat but keeps its memory.

Switches and instructions save as you change them. Other changes, such as the name, model,
computer or voice, show **Save** at the bottom of **Advanced**.

You can also ask the bot in chat to change its name, instructions, model, thinking, voice and
read-aloud. A new set of instructions follows your [approvals](/docs/approvals/): when they ask, an
**Update instructions?** card shows the change. Model, thinking and voice changes apply at once with
**Undo**. Computer, tools, permissions and memory scope stay in Settings, since they change what
the bot can reach.

On someone else's bot in a [team space](/docs/teams/#shared-bots), you see only **Notifications** and
**Open work** under **Advanced**.

## Organize the sidebar

Right-click a bot in the sidebar to **Pin** it, **Make primary**, **Move to** a section, **Mark as
Unread**, **Edit Profile**, **Duplicate**, **Clear conversation**, **Archive** or **Delete** it.
Archived bots can be restored later.

**Duplicate** makes a new bot with the same instructions, description, look, model, computer
setting, disabled tools and MCP servers. Its memory, routines and chat
aren't copied.

Bots in a [team space](/docs/teams/#shared-bots) are shared. Only the person who made one and the
team's owners and admins can change, archive or delete it.

One bot can be your [primary bot](/docs/primary-bot/), which suggests work on a schedule you choose.

## Find things

- **Search** in the sidebar searches bots and conversations. Press Cmd+K (Ctrl+K on Windows and
  Linux) to jump to any bot.
- **Activity** in the sidebar lists every run, with filters for status and date. Use it to find a
  run that failed or is waiting on you.
- **Library** lists every file and [page](/docs/pages/) bots have made, with tabs for **Files**,
  **Pages** and **Shared with me**, search, and filters by bot and date. On web and the desktop app,
  open it from the account menu under **Workspace tools**; on mobile, it's in the account screen. A
  bot's own files are in the **Library** tab of its settings, with **View all files**.
