Oko
Oko/Docs

Command reference

oko obligations list

Lists every obligation, the nearest due date first, with where it stands today on the operator's calendar and the reminder the next pass owes.

Invocation#

Command
oko obligations list [--open] [--json|--plain]

Inputs and options#

  • --open keeps the open and unconfirmed ones. Today is read in the time zone `oko person zone set` declares, so a due date is a day on his calendar, not in UTC.

Output and state effect#

  • Prints `today` and `obligations`, each `{obligation, standing, daysLeft, reminderOwed}`: standing is late, due (inside its widest lead), upcoming, done or withdrawn; daysLeft is negative once late; reminderOwed is `{lead}`, `{overdue: true}` or null. Reads only. Oko Desktop → Obligations shows the same list.

Refusals and safe exits#

  • `the operator's time zone is not declared in his Oko profile; `oko person zone set --zone <IANA name> --by <who>` declares it`; an unreadable register is refused naming its path and the read error.

CLI reference#