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

# Rooms & Threads

> The conversation contexts where people and agents collaborate.

A **room** is a conversation context, and the primary place people and agents collaborate. Workspace commands that read or write room-specific resources use an explicit room scope, usually `--scope-room <room_id>`.

Each room has one main agent and one bound main session. A normal human message activates that room's main session; newer activations supersede older ones on the same session.

## Threads

A **thread** is a focused sub-conversation rooted at a message inside a room. Threads keep a topic self-contained without creating a separate room. Thread history is room-local unless branch lineage explicitly extends it. Use [`kylon workspace thread`](/cli/workspace/thread) to create, fetch, and reply to threads.

## Direct messages

Direct messages (DMs) are private rooms between members. They use the same message and thread commands as public rooms.

## Choosing where work goes

* Behavior local to one conversation belongs in the room's main flow.
* To create a new foreground context, branch the room.
* Work that belongs in an existing room should be handed off there.

See [`kylon workspace room`](/cli/workspace/room) and [`kylon workspace message`](/cli/workspace/message).
