DocumentationWorkflows and watchers
Docs/Use OpenNeko

Workflows and watchers

Turn repeated checks and operating routines into work that runs on schedule or when a condition appears.

Choose the mechanism

UseWhenResult
WatcherA condition in approved data should be checked repeatedly.Creates a finding when the condition is met.
WorkflowA repeatable sequence needs several steps, tools, or decisions.Runs the sequence and records each result.
ScheduleThe work should run at a predictable time.Starts the watcher or workflow without a person prompting it.

Design a useful watcher

  1. Name the condition in business language.
  2. Choose the smallest approved data set that can prove it.
  3. Set a cadence that matches how quickly a person could act.
  4. Define what should happen when the condition is found.
  5. Test with dry-run behavior before allowing consequential actions.

Review runs

Use run history to see when the work started, which inputs it used, which steps completed, and whether an action was proposed or executed. Failed runs should remain inspectable rather than disappearing into a generic notification.