Oko
Oko/Docs

Command reference

oko goals extract

Runs the local goal lifecycle model over Transcript Lake user turns.

Invocation#

Command
oko goals extract (--file PATH | --limit N) [--pace MS] [--digest]

Inputs and options#

  • --file selects one transcript; --limit N the N newest exported transcripts. One of the two is required: “oko goals extract needs --file PATH (one transcript) or --limit N (the N newest exported)”; a --limit that is not a whole number above zero is refused by name.
  • --pace throttles classification; --digest requests a daily-wins note when available.

Output and state effect#

  • Prints each classification, the projected goals, token totals, and optional digest; stored goals are unchanged.

Refusals and safe exits#

  • Unknown goals subcommands are refused; individual classification failures are reported and skipped, and digest generation requires macOS 26 with an available local model.

CLI reference#