Cycles

Cycles are xpo's built-in sprint system — a regular planning rhythm with automatic rollover of unfinished work.

Enable cycles

xpo cycle init --duration 2w --start monday

Or configure directly in config.yaml:

cycles:
  enabled: true
  duration: 2w
  start_day: monday
  anchor_date: "2025-01-06"

The anchor_date is optional. If omitted, xpo anchors to the nearest start_day before now. Use it to align cycles with an existing sprint calendar.

View cycle info

xpo cycle                         # current cycle + issues
xpo cycle next                    # next cycle info

Automatic rollover

Issues not marked DONE by the end of a cycle automatically roll forward to the current cycle. Completed issues retain their original cycle ID so historical stats stay accurate.