Skip to main content
The composer is where you give the agent tasks and add requirements. The new chat page and the session page use the same composer. For the project and run environment selection above it on the new chat page, see New session.

Where this applies

Parts of the composer

Keys:
  • Enter sends, Shift+Enter adds a new line.
  • While the turn is running, press Esc to stop the current task.
  • When the message box is empty, press ↑ to edit your last message (when the current agent supports it); see Messages and session actions.

Attachments

Add attachments

  • Click + and choose Upload files or images or Take a screenshot.
  • Drag files onto the message box, or paste a screenshot or file directly.
You can send attachments without any text. When the cursor is at the very start of the message box, press Backspace twice to delete the last attachment.

Limits

Files over a limit are not added, and the rest are added as usual. HEIC, HEIF, and TIFF images are automatically converted to JPEG.

Whether you can add images and files

When you cannot add them, the corresponding item in the + menu is grayed out with the reason:

Attachment states

While any attachment is still uploading, converting, or has failed to upload, the send button is unavailable, with Send when attachments are ready.

Local references (desktop app)

When the session runs on this computer, files added in the desktop app are given to the agent as Local reference. They are not uploaded and are not counted toward the 100 MB total. Files outside the project folder are copied into the project folder first (showing Copying to an allowed folder). If a file cannot be referenced, the attachment shows the reason. Images are still uploaded as usual.

Take a screenshot

The image captured with Take a screenshot in the + menu becomes a pending attachment directly: If capture fails, you see Couldn’t take the screenshot. Try again.

Attachments in sent messages

Click an image to view it larger; click a file to download it. Locally referenced files show only the file name and cannot be downloaded.

Slash commands

Type / at the start of the message box to open the command list, and keep typing to filter it. Commands are listed for the current session’s project, agent, and run environment, in the groups Source device · Device only, Cloud shared, Project, and Built-in.
  • Use ↑ ↓ to select, Enter or Tab to insert, and Esc to close.
  • Selecting a command only inserts it into the message box; it is not sent directly.
  • Commands you cannot use are grayed out with the reason. The most common is Choose the source device to use this command (the command is installed only on a specific device, and the session does not run on that device).
To add and manage plugins and Skills, see Plugins, MCP, and Skills.

Adding messages while running: queue and steer

While the agent is working, you can keep writing. There are two ways to send (when the session is idle, messages are sent directly):

How to choose

  • The default method is set in Settings › General; see “Default method setting” below.
  • When the default is queue, a Queue | Steer toggle appears next to the send button, and you can switch this one message to steer.
  • ⌘Enter (Windows Ctrl+Enter): sends this message with the method opposite to the default.

When the agent does not support steering

Currently only Claude Code and Codex support steering. With other agents, Steer is grayed out and all messages are sent as queued.

Queue area

Queued messages show above the message box, one per row. Messages queued by a session timer have a ⏰ Timer label. You see the same queue after refreshing the page or opening it on another device.

After stopping the turn

  • If you clicked Stop this turn here: queued messages continue to be sent in their original order.
  • If the turn was stopped elsewhere (for example, on another device): the queue pauses, and the queue area shows Queue paused and Send all. You can also Send or delete them one at a time.

Default method setting

Messages sent mid-turn in the Chat group of Settings › General: Queue (default) or Steer. This setting is saved to your account and shared by the desktop app and web app.

Stop this turn

While the turn is running and the message box is empty, the send button becomes Stop this turn. Click it or press Esc to stop. For what happens after stopping, see Errors and recovery.

Error area above the message box

Errors related to the current session (sending, uploading, network, preview, unavailable source, and so on) all show directly above the message box. Each card has a description and one main action, such as Retry or Sign in. For each type of error and how to handle it, see Errors and recovery.

FAQ

What if an attachment keeps showing Upload incomplete?

Click the retry button on the attachment to upload it again. If it fails repeatedly, check your network, or remove it and add it again.

Why is the send button grayed out?

Usually an attachment is still uploading or converting, or has failed to upload. Wait for it to finish, or retry or remove the failed attachment.

What happens to queued messages when I click stop?

When you click stop here, queued messages continue to be sent in order. If the turn was stopped elsewhere, the queue pauses, and you need to click Send all or Send on each one.

I want steer by default. Why was my message queued?

When the current agent does not support steering, messages are handled as queued automatically. Claude Code and Codex support steering.

Why is a slash command grayed out?

Check the reason below the command. Most often, the command is installed only on a specific device, and the current session does not run on that device.