Command reference
oko autonomy tick
Attempts one bounded autonomous-goal execution under the saved policy.
Invocation#
oko autonomy tick [--state-dir PATH]Inputs and options#
- --state-dir selects the policy/state directory; limits, backoff, runtime, and allowed scope come from its saved policy.
Output and state effect#
- May acquire a lease, stage/update a run, pursue one eligible active goal, and persist its receipt/state.
Refusals and safe exits#
- Returns “disabled” when no policy is stored or the policy is disabled; returns without work when already running, over the daily limit, in retry backoff, or no goal is eligible. A run older than the policy's maximum runtime, or whose lease holder's process is gone, is taken for abandoned. Invalid policy/state and execution failures are recorded and fail.
- “busy” means only that another tick holds <state-dir>/tick.lock. A lease that cannot be read is refused with `autonomy lease <path> cannot be read: <cause>`, and a stale or abandoned one that cannot be removed with `autonomy lease <path> is stale or its holder is gone, but cannot be removed: <cause>`; the lock is left as it is and nothing runs, so an unreadable lock never stops autonomy silently.