Stream run events

Opens a server-sent event stream of one run’s live events, the way cliq run shows progress. Pass the run id (not the name) in the run_id query parameter.

From the CLI: cliq run.

No credential is needed from this machine. From another host, send Authorization: Bearer with a dispatch token CliqHub signed for this daemon or a cliq_tok_… personal token of a user in the daemon’s realm; this only works once the daemon is connected to CliqHub. See Authentication.

GET /v1/runs/events

Stream run events

cURL

curl --request GET \
  --url http://127.0.0.1:4900/v1/runs/events \
  --header 'Authorization: Bearer <token>'

200

Example

event: connected data: {"run_id":"0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f","state":"running"} event: phase.started data: {"id":1840,"event_type":"phase.started","phase":"review","agent":"claude-code","payload":null,"created_at":1759834210000} event: phase.completed data: {"id":1842,"event_type":"phase.completed","phase":"review","agent":"claude-code","payload":{"message":"3 findings"},"created_at":1759834480000} event: run_end data: {"run_id":"0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f","state":"completed","error":null}

Authorizations

Authorization · string · header · required

Not needed from the same machine. From another host: a dispatch JWT CliqHub signed for this daemon, or a cliq_tok_… personal token whose user is in the daemon's realm.

Query Parameters

run_id · string · required

Run id

Minimum string length: 1

Response

200

text/event-stream

A text/event-stream that ends with run_end.

A text/event-stream. Each message is event: <type> and data: <JSON>:

• connected — first, with { run_id, state }.
• one message per run event as it happens, named by its type (phase.started, phase.completed, phase.input_required, run.completed, …), with { id, event_type, phase, agent, payload, created_at }.
• run_end — last, with { run_id, state, error }; then the stream closes.

Events are not replayed: you see what happens after you connect. A run that has already finished gets connected and run_end at once. Read history with Read a run log.