Find a conversation

Steps

1. Select the search box

   At the top of the conversation list, select Search conversations….

2. Type a word or phrase

   The list updates as you type. Once you move out of the search box, the list’s heading says Search results. Search looks through your messages, the agent’s replies, the agent’s questions, conversation titles and labels, and the names of workflows used in messages.

3. Decide whether to include completed conversations

   Below the search box, Show completed is selected while you search, so completed conversations are included. Clear it to leave them out.

4. Open a result

   Select a conversation. When one of its messages matches, it opens at the first message that does.

5. Clear the search

   Select the X at the end of the search box to see the whole list again.

Good to know

• To narrow the list without searching, use the filters above it: All, Needs you, Working, and Unread. Each shows how many conversations it contains.
• The list shows the most recently active conversations first. Once any conversation works in a worktree, the list is grouped by the folder each conversation works in.
• Clearing the search brings back the Show completed choice you had before you searched.
• With no conversation open, pressing ⌘F on a Mac, or Ctrl+F on Windows and Linux, jumps to the search box. With a conversation open, the same shortcut searches inside that conversation. See Find words in a conversation.
• To fit more conversations on screen, or to show or hide previews, agent names, and dates, see Use Compact view for conversations and messages.
• In the iPhone app, use Search conversations at the top of a project’s conversation list. The Completed filter there opens your completed conversations, with its own search.

If something goes wrong

“No matching conversations”

Nothing matches what you typed. Try a different or shorter word, and make sure Show completed is selected. Select Clear search to see the whole list.

The list is empty but you have conversations

A filter or setting is hiding them.

• “You’re all caught up” with “No open conversations.” means every conversation is completed and Show completed is off. Select Show completed at the bottom of the list.
• “You’re all caught up”, “Nothing working right now”, or “All read” means the Needs you, Working, or Unread filter is selected. Select View all conversations to go back to All.