Skip to main content

Real-time events

Subscribe to a long-lived SSE stream of document status transitions for live progress UIs.

Real-time event stream#

Subscribe to documents/events and handle reconnects and catch-up.

The collection events stream pushes status transitions for every document in a collection. The connection stays open indefinitely and sends a ping every 20 seconds; EventSource auto-reconnects on socket drop. Events emitted during a reconnect gap are not replayed — if you need a precise audit log, re-fetch the document list after any disconnect.

# CLI watch: streams status events; reconnects on its own.
dewey watch my-docs

See also