Oko/Docs

Command reference

oko blockers held

Names the open items a build itself unblocks: each item an open blocker holds while it waits (`--waits-on`) on an open defect whose repair is pushed. Only that build delivers what lifts the refusal, so `oko admit` does not hold a session's build on these items, and Tama's stop gate reads the same list.

Invocation#

Command
oko blockers held [--json]

Inputs and options#

  • Takes nothing but --json; the blocker's `blocks` names the item first, before `:` or a space.

Output and state effect#

  • Prints one short item id per line, or `no open item is held for the build: no open blocker waits on a defect whose repair is pushed`. With --json prints the ids as a JSON list. Reads the blocker and defect registers only. The native API answers the same (`blockers` `held`).

Refusals and safe exits#

  • `oko blockers held does not take <flags>; it takes --json` and `oko blockers held takes only flags; it was given <word>, which it would not read` (exit 2); the blocker and defect registers' read refusals.

CLI reference#