Skip to main content
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 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 and kylon workspace message.