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

# Write with the agent

In a project, the agent reads your files, your library and your notes, and proposes changes. It never changes your text on its own: you apply what you want.

> [!NOTE]
>
> **Before you start**
>
> The built-in agent needs a subscription and uses [AI credits](https://help.milton.so/account/ai-credits.md). On any plan, you can use your own [local agent](https://help.milton.so/ai/local-agents.md) (Claude Code or Codex) instead.

## Open the agent

In a project, click the **Agent panel** button (robot icon) in the header. It also opens when you go to the **Writing** tab.

Type your request in plain words, for example "Shorten the introduction to 300 words" or "Find references that support the second paragraph". Type **@** to point the agent to references, collections, projects or files, and **/** to use a [skill](https://help.milton.so/ai/skills-and-guided-plan.md).

![A project with the Agent panel open on the right and a request being typed](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/agent-panel-open.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=60834ae43e0d11d7d24cff286bccae7f)

Choose the model in the model menu: Claude Sonnet 5.5 (default), Claude Opus 5.5 or Claude Fable 5.1.

## Review the changes

The agent's proposals appear as cards. For each change:

* **Apply** or **Discard**, or **Apply all** / **Discard all**
* **Create file** for a new file
* **Side by side** or **Inline** to compare

To apply changes without reviewing them, turn on **Apply changes automatically** (the lightning icon). It's off by default and only affects the current chat.

Changed your mind? Click **Undo agent changes** at the end of the conversation. Changes you edited since are left alone.

![An agent suggestion card with a proposed edit and the Apply and Discard buttons](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/agent-suggestion-card.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=8c6e2f9bd94fec0df09e91fa5441b4dc)

## Ask about a selection

Select text in a file, then right-click (or press **Mod + Shift + A**) and choose **Polish**, **Rephrase**, **Shorten**, **Fix the English**, **Suggest citations**, **Check citations** or **Ask the agent…**.

![The menu on a selected sentence with Polish, Rephrase, Shorten, Fix the English, Suggest citations, Check citations and Ask the agent…](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/agent-selection-actions.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=4de4bc29fe7176d4f275d212d928d350)

## What the agent can do for you

Just ask; it picks the right specialist:

* **Find references** in your library.
* **Support a claim**: it searches the text of every PDF in your library and your notes, then shows references that **Supports** or **Qualifies or contradicts** your sentence. Choose them and click **Cite selected** or **Add to project**.
* **Check the LaTeX** and fix compile errors. You can also click **Fix with agent** on a compile error.
* **Check the maths**: it recomputes numbers and statistics and tells you what doesn't add up. It never changes your numbers itself.
* **Search outside your library**: it can search the web and Crossref. Works it finds arrive as cards with **Add to library** or **Discard**; it only cites them once you've added them. Each web search uses credits.

Click **Ran N tools** under a message to see what the agent did.

![Ran N tools opened under an agent message](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/agent-ran-tools.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=0c422a2a6d6bc4353706f5d252190b6a)

## In a shared project

See [Write together in real time](https://help.milton.so/collaboration/write-together.md#the-agent-in-a-shared-project).


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