added 2026-10-05
List a project's cycles (numbered time boxes for issues), newest first: dates, state, goal, open/done counts, rev. Number = cycle= of update_issue. cycle=N: report. Answers are compact JSON; pass format="text" for a readable Markdown answer. Results are paged: if the answer has a cursor, call again with it (a missing cursor means the last page) — never assume the first page is everything.
cursorstringoptionalCursor from `Next page` of an earlier result of this call (omit for the first page); pass it unchanged, with the same other argumentscycleintegeroptionalformatenumoptionalAnswer format: "json" (default) is one compact JSON document; "text" is a readable Markdown answerjsontextlimitintegeroptionalHow many cycles per page (1–50, default 20)projectstringrequiredProject keystateenumoptionalopen is planned and activeplannedactivecompletedopen
Returns
One of these shapes, depending on the arguments:
Shape 1
countintegerrequiredcyclesarray of object | nullrequiredlimitintegerrequiredprojectstringrequired
Shape 2
Optional fields, when present
cursorstringoptionalnotestringoptionalpageintegeroptionalpagesintegeroptionalreportobjectoptionaltotalintegeroptionaltotalApproximatebooleanoptional
- 2026-10-05 — New optional cycle argument (a number): answers that cycle and its `report` (not for a planned one): committed at start and added later, each split into done, unfinished and removed, with rolled_in; rolled_out (and rolled_out_to); blocked_now for the active cycle; flow (cycle_time and review: n, unavailable, median_sec, max_sec; not_started). Durations are calendar time by today's status categories; what the history cannot prove is unavailable, never 0. format="text" prints the definitions.