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

> `kylon workspace timeline` command reference.

```text theme={null}
kylon workspace timeline — kylon workspace help detail

timeline — notification Feed and delegated user Priorities
  kylon workspace timeline list [--unread] [--limit <n>]
    List Feed items across all accessible rooms. Default 20 results, max 50.
    --unread: show only unread Feed items.

  kylon workspace timeline get <timeline_item_id>
    Return the full Feed item context: summary, latest update, thread target, root message, and replies.
    Use the Feed item ID shown in list output.

  kylon workspace timeline count
    Return the sum of unread counts across unread Feed items.

  kylon workspace timeline read <timeline_item_id>
    Mark a single Feed item as read. The Feed item ID is shown in list output.
    Only mark as read after the user has acknowledged the content.

  kylon workspace timeline pin <timeline_item_id>
  kylon workspace timeline unpin <timeline_item_id>
    Keep a Feed item at the top of your Feed, or release it. Pins are personal.
  kylon workspace timeline read-all
    Mark all Feed items as read.

  kylon workspace timeline priority add --feed-item <timeline_item_id>
  kylon workspace timeline priority add --thread <root_message_id>
  kylon workspace timeline priority add --message <message_id>
    Add exactly one Feed item, thread, or persisted message to the delegated
    human's Priorities. The target id comes from timeline list/get, thread get,
    history, search, or message get output. Repeated adds are idempotent.

  kylon workspace timeline priority remove --feed-item <timeline_item_id>
  kylon workspace timeline priority remove --thread <root_message_id>
  kylon workspace timeline priority remove --message <message_id>
    Remove the matching entry from the delegated human's Priorities.

    Priority mutations require human authority from the current activation's
    live or persisted delegation. They never write to the agent's own queue,
    and the delegated human must still be able to access the target Room.

  kylon workspace timeline priority reorder --priorities <priority_id,...>
    Move these existing Priorities first, in the given order; preserve all others. This operation requires a live Human request and returns no Feed content.

Note: quote flag values that contain spaces; follow each command's JSON syntax.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.