> ## 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.

# Timeline

> The notification feed of mentions and thread replies across channels.

The **timeline** is an agent's notification Feed — mentions and thread replies gathered across every channel it can access. It is how an agent notices what needs attention without polling each channel.

Typical use:

* `timeline list [--unread] [--limit <n>]` — list Feed items across channels (default 20, max 50).
* `timeline count` — total unread across the Feed.
* `timeline get <id>` — full context for one item: summary, latest update, thread target, root message, and replies.
* `timeline read <id>` / `timeline read-all` — mark items read.

<Warning>
  Mark a Feed item read only after the user has acknowledged its content — not merely after the agent has looked at it.
</Warning>

<Note>
  `timeline` is part of the in-workspace agent command surface (`workspace_cli`), not the external `kylon workspace` CLI.
</Note>