# Commands

> Short messages that control the conversation itself. They work in the browser, on Telegram and on WhatsApp.

Commands are short messages that start with `!` and control the conversation itself, such as starting a new one or stopping a reply. They are most useful on Telegram and WhatsApp, where there are no buttons to press. Commands are free, except for `!compact`, which is billed like a normal reply.

You can also just ask your agent in your own words, for example "switch to the cheaper model", "turn on Notion" or "how do I set up salts-tools?". Your agent can run most commands for you and reads this guide to answer questions about Salts. A request in your own words is billed like a normal reply. `!stop`, `!unstick` and `!delete` only work when you send them yourself.

To use a command, send it as the whole message, for example `!new`. In a Telegram group, mention the bot first, for example `@ada_salt_bot !new`.

| Command | What it does |
|---|---|
| `!new` | Starts a new conversation. The old one is kept in your browser. |
| `!clear` | Starts a new conversation and deletes the old one. |
| `!stop` | Stops the reply your agent is writing right now. |
| `!compact` | Summarises the older part of the conversation, so replies become cheaper. |
| `!unstick` | Fixes a conversation where your agent has stopped responding. |
| `!delete` | Deletes this conversation and everything in it. |
| `!help` | Lists every command. |
| `!docs` | Lists the pages of this guide. |
| `!docs <page>` | Sends one page of this guide. |
| `!settings` | Sends a link to your agent's settings. |
| `!mcp` | Lists your connected apps and whether each is on. |
| `!mcp <name>` | Switches a connected app on if it is off, or off if it is on. |
| `!model` | Shows the current model and lists the models you can switch to. |
| `!model <nickname>` | Switches your agent to another model. |

## !new

We recommend sending `!new` whenever you change the subject. Your agent starts fresh, which makes replies cheaper, faster and less likely to get confused by the earlier conversation. The old conversation is still available in your browser, and anything you scheduled in it, such as a daily reminder, carries over to the new one.

In the browser, `!new` opens a new session, the same as the **+** button in the sidebar. Anything you scheduled stays with the old session there.

## !clear

`!clear` does the same as `!new`, but also deletes the old conversation along with its messages and files. This cannot be undone.

If your agent has reached its limit of sessions and refuses `!new`, `!clear` will still work, since it frees up a slot. In the browser, `!clear` deletes the session you are in and opens a new one, along with anything scheduled in it.

## !stop

Send `!stop` while your agent is still writing to stop the reply. This is useful when you asked the wrong question, or the reply is going in the wrong direction and you do not want to pay for the rest of it. In the browser, you can use the stop button next to the message box instead.

## !compact

`!compact` replaces the older part of the conversation with a short summary, so every reply after it is cheaper. Nothing is deleted from your browser. Read [Why and when to compact](/guide/compacting) to learn when to use it.

## !unstick

Very rarely, a reply never finishes and your agent stops responding to anything you send. `!unstick` fixes this without deleting anything. Afterwards, ask your question again. We recommend always trying `!unstick` before `!delete`.

## !delete

`!delete` deletes the conversation, along with its messages, files and scheduled tasks. This cannot be undone. Anything your agent saved to its memory is not deleted.

## !help, !docs and !settings

`!help` explains how conversations work and lists every command. `!settings` sends a link to your agent's **Settings** page.

`!docs` sends a link to this guide and lists its pages, each with a short name. Send that name after `!docs` to read the page right in the chat, for example:

```
!docs openrouter
```

## !mcp

Apps you connect to your agent, such as Notion or GitHub, make every reply a little more expensive, even when they are not used. `!mcp` lets you switch an app on only when you need it. Send `!mcp` on its own to see every app and whether it is on. Add the name the app has on your **Capabilities** page to switch it: an app that is off is switched on, and an app that is on is switched off. Your agent replies with where the app ended up. For example:

```
!mcp Notion
```

The app must already be connected on the **Capabilities** page before you can switch it on this way. An app switched off for Telegram groups on the **Capabilities** page is marked **Not offered in Telegram groups**.

## !model

`!model` switches your agent to another model from the list in **Settings** under **Model**. It uses the model's nickname, which is the part of its name in brackets. For example, a model named **DeepSeek V4 Flash (ds)** has the nickname `ds`, so this switches to it:

```
!model ds
```

The switch is the same as picking the model in **Settings**, so it applies to the whole agent, not just this conversation. The next reply uses the new model.

Send `!model` on its own to see which model your agent is using now, and every nickname, with the current model marked.

A model without brackets in its name has no nickname and can only be picked in **Settings**. If the model is locked by whoever manages your agent, `!model` does not work.
