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

# Chats and context

> History, attachments, voice input, web search, and the project context Wren carries into every conversation.

Everything about working *in* a Wren chat: what it remembers, what you can hand it, and what it can reach for.

<Frame caption="The composer: web search, attachments, project context, and the mode selector">
  <img src="https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/composer.png?fit=max&auto=format&n=2HU5oeXXTczVAKux&q=85&s=3d5e8be1f6df72c827fd418ca3f2e994" alt="Wren composer showing the web search globe, attachment paperclip, Project context link, and mode selector" style={{ maxWidth: '760px', width: '100%', margin: '0 auto', display: 'block' }} width="1568" height="321" data-path="images/wren/composer.png" />
</Frame>

## Conversations and history

Chats are saved to the **History** panel, scoped to the project you're in. You can resume any past chat, switch between concurrent ones, or archive what you're not using. Open history with <kbd>⌘</kbd>+<kbd>.</kbd>, or start a fresh chat with <kbd>⌘</kbd>+<kbd>/</kbd>.

History is grouped by when you last touched a chat (Today, Yesterday, Last 7 Days, Last 30 Days, and Older) and scrolls back as far as you need.

<Frame caption="Chat history, grouped by when you last used each conversation">
  <img src="https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/chat-history.png?fit=max&auto=format&n=2HU5oeXXTczVAKux&q=85&s=6351b9d58c9258889c5c90cdd6b15bd8" alt="Wren chat history panel with a Start a new chat button and conversations grouped under Today" style={{ maxWidth: '340px', width: '100%', margin: '0 auto', display: 'block' }} width="508" height="429" data-path="images/wren/chat-history.png" />
</Frame>

**Titles are written for you.** Wren names each chat from your first message, and renames it if the conversation changes direction. Chats can't be renamed by hand.

**History shows your own chats.** Other people's conversations in the same project don't appear in your list, even though you're both working on the same agent.

<Warning>
  **Archiving is permanent.** Archiving a conversation removes your access to it for good. There's no restore. Archive things you're finished with, not things you might want later.
</Warning>

### Picking up where you left off

Resuming a chat restores more than the transcript. Wren re-syncs your project, restores the working state it had built up, and tells you what it's picking up on, including if you've since switched branches.

If a run is interrupted, because you closed the tab or your connection dropped, the work keeps going server-side. Reopening the chat rejoins it.

### Past Smart Analyst chats

Analyses you ran in Smart Analyst before it was retired appear in your history alongside your Wren chats. They're **read-only**: you can read them back, but you can't continue them. Start a new chat to ask a follow-up.

### Sharing a chat

Copy a link to a conversation from the chat's **⋯** menu and send it to a teammate with access to the project. They'll see the full conversation with a read-only banner. They can read it, but they can't continue it or act on it.

This is the only way to show someone a chat, since history only ever lists your own.

## Attachments

Drag in transcripts, policy documents, spreadsheets, or screenshots and Wren reads them as part of your request.

You can attach **up to 10 files per message**, each up to **10 MB**.

| Kind              | Formats                                                 |
| ----------------- | ------------------------------------------------------- |
| **Images**        | JPG, JPEG, PNG, GIF, WEBP                               |
| **Documents**     | PDF, DOCX, XLSX, XLS, PPTX, EML                         |
| **Text and data** | TXT, LOG, CSV, TSV, MD, JSON, HTML, HTM, XML, YAML, YML |
| **Archives**      | ZIP (up to 50 files, 50 MB uncompressed)                |

Images are read directly. Everything else is converted to text first, so a scanned PDF with no text layer gives Wren nothing to work with, and it'll tell you so rather than guessing at the contents.

<Warning>
  **Attachments expire five minutes after you add them.** If you attach a file and then get pulled away before sending, the upload may have expired by the time you hit send. Wren tells you the attachments couldn't be read. Re-attach and send again.
</Warning>

Large files aren't truncated away: Wren keeps a full copy it can page through, so a long transcript stays usable even when only a preview appears in the message itself.

## Voice input

You can speak to Wren instead of typing. Hold the microphone button, or hold <kbd>⌥</kbd>+<kbd>Space</kbd> (<kbd>Ctrl</kbd>+<kbd>Space</kbd> on Windows), and talk. Release to drop the transcript into the composer, where you can edit it before sending. Press <kbd>Esc</kbd> while recording to discard it.

You can also click the microphone to toggle recording on and off rather than holding.

A few things to know:

* The keyboard shortcut only works once you've granted microphone access by clicking the button at least once.
* Sessions stop automatically after 5 minutes, or after 15 seconds of silence.
* **Safari isn't supported.** Use Chrome, Edge, or Firefox for voice input.
* Dictation counts toward your [usage allowance](/wren/usage-and-limits), at a small fraction of the cost of a message.

Voice input is for dictating a message. It isn't a spoken conversation with Wren.

## Web search

Wren can search the web and read public pages, which is what makes *"add topics from `https://example.com/faq`"* work.

The globe icon in the composer toggles this per conversation. Turn it off if you want Wren working strictly from your project and your own messages. Web searches count toward your usage allowance.

## Project context

If you find yourself explaining the same background in every chat (your domain, your house style, rules the agent must always follow), write it down once instead.

**Project context** is a document Wren reads at the start of every conversation in the project. Open it from the composer or the sidebar. It's a good place for:

* **Prompt style:** how you want the agent's wording to read
* **Business context:** what your company does, and the vocabulary that goes with it
* **Agent structure:** conventions you want new flows and topics to follow
* **Rules for Wren:** anything it should always or never do in this project

<Frame caption="Project context: written once, read at the start of every chat">
  <img src="https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/project-context.png?fit=max&auto=format&n=2HU5oeXXTczVAKux&q=85&s=97120dd17c082e5ea3da69b7baa55ce2" alt="Project context editor with sections for Prompt Style, Business Context, Agent Structure, and Rules for Wren" style={{ maxWidth: '620px', width: '100%', margin: '0 auto', display: 'block' }} width="1228" height="980" data-path="images/wren/project-context.png" />
</Frame>

Editing it requires write access to the project; read-only users can view it.

## Long chats

Wren remembers everything in the current chat. Follow-ups like *"now do the same for the cancellation flow"* work without repeating context.

When a chat gets long enough to strain that memory, Wren summarizes the earlier part and keeps going. You'll see a **Compacting context…** line in the transcript when it happens, followed by a note of how many messages were summarized. Nothing is lost from the transcript you can read; it's the working memory that gets condensed.

Compaction is automatic and safe, but a summarized chat is still less sharp than a fresh one. **Start a new chat when you switch to unrelated work.** It's faster, cheaper, and keeps Wren focused on the thing you're actually doing.

## Related pages

<CardGroup cols={3}>
  <Card title="Prompting guide" icon="message-pen" href="/wren/prompting">
    Patterns for getting good results in fewer turns.
  </Card>

  <Card title="Usage and limits" icon="gauge" href="/wren/usage-and-limits">
    What counts toward your allowance.
  </Card>

  <Card title="Overview" icon="cards-blank" href="/wren/introduction">
    Modes, plans, branches, and keyboard shortcuts.
  </Card>
</CardGroup>
