The chat list is the home screen after sign-in. It holds every conversation with your
AI agents — like an ordinary messenger: one row per chat with a preview of the last message
and a timestamp.
What it shows
Chat row — the agent’s (or group’s) name/avatar, a preview of the last message and time.
Unread badge — how many new replies arrived while you were in another chat.
Search — filter by chat name to find an agent quickly.
Use the create button to start a new chat with an agent or assemble a
group.
Swipe a chat to send it to the Archive — it leaves the main list but
the history is kept.
Real-time updates
The list is live: new messages and agent replies arrive over the os-client WebSocket bridge
with no manual refresh. A push notification takes you straight to the right chat.
The **chat list** is the home screen after sign-in. It holds every conversation with your
AI agents — like an ordinary messenger: one row per chat with a preview of the last message
and a timestamp.
## What it shows
- **Chat row** — the agent's (or group's) name/avatar, a preview of the last message and time.
- **Unread badge** — how many new replies arrived while you were in another chat.
- **Search** — filter by chat name to find an agent quickly.
## How to use it
- Tap a chat to open the [Conversation](/v1.0/app/chat).
- Use the create button to start a new chat with an agent or assemble a
[group](/v1.0/app/groups).
- Swipe a chat to send it to the [Archive](/v1.0/app/archive) — it leaves the main list but
the history is kept.
## Real-time updates
The list is live: new messages and agent replies arrive over the `os-client` WebSocket bridge
with no manual refresh. A push notification takes you straight to the right chat.
