watch
Poll Jira for changes and emit NDJSON events
Watch a JQL query or single issue for changes and stream events as NDJSON.
First poll emits all matching issues as "initial" events. Subsequent polls emit "created", "updated", or "removed" events only for issues that changed.
Supports --preset, --jq, and --fields for output shaping. Each event is one JSON line: {"type":"updated","issue":{...}}
Use Ctrl-C (SIGINT) to stop gracefully.
POST /rest/api/3/search/jql
| Flag | Type | Required | Description |
|---|---|---|---|
--interval | duration | No | poll interval (e.g. 10s, 1m, 5m) |
--issue | string | No | single issue key to watch (e.g. PROJ-123) |
--jql | string | No | JQL query to watch |
--max-events | int | No | stop after N events (default: unlimited) |
Example:
bash
jr watch