Skip to content

Organize and Search Chats

Use the sidebar to keep ongoing conversations close and find earlier messages. On a narrow screen, open the sidebar to reach these controls.

Pin an important conversation, archive a completed chat, and search saved messages.

Pin or rename a chat

Open the ⋯ (Chat actions) menu beside a conversation.

  • Select Pin chat to put it in the Pinned group at the top of the list. Select Unpin chat to return it to its date group.
  • Select Rename, enter a title, and press Enter. Press Escape to cancel.

The menu appears when you hover over or focus a row; it is also available on touchscreens. You can open it with the keyboard and use arrow keys to move between actions.

Archive a finished conversation

  1. Open Chat actions and select Archive.
  2. Select Archived above the chat list to find it again.
  3. To restore it, open its menu and select Unarchive.

The Chats tab shows unarchived conversations. Archiving keeps the chat's messages and files; Delete is a separate action with a confirmation dialog.

Find a message

  1. Choose Chats or Archived. Search uses the selected tab.
  2. Enter a word or phrase in Search chats.... Ctrl/Cmd+K focuses this field.
  3. Select a result. A message match opens the chat at that message and briefly highlights it. A title-only match opens the conversation normally.

Search checks titles and the text of user messages, assistant replies, and tool results. It shows one result per matching chat, with a snippet from the first matching message when there is one. It does not search the separate reasoning trace field or files that have never appeared as message text.

If a conversation is missing, switch tabs and search again. Clear the search field to return to the normal list.

API access

For scripts and custom clients, use the authenticated chat endpoints. The UI always sends an archive filter; API calls can omit it to include both active and archived chats.

Request Purpose
PATCH /api/v1/chats/{chat_id}/organization Set either or both of pinned and archived
GET /api/v1/chats/?archived=false&limit=20 List unarchived chats
GET /api/v1/chats/?archived=true&limit=20 List archived chats
GET /api/v1/chats/search?q=architecture Search both lists

For example, pin a chat and restore it to the active list:

curl -X PATCH http://localhost:4567/api/v1/chats/YOUR_CHAT_UUID/organization \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pinned": true, "archived": false}'

Search returns up to 50 chat objects, each with a snippet and nullable message_id alongside the normal chat fields. A non-null message_id identifies the message to navigate to; it is not a list of every match.