Skip to content
ukkin Star on GitHub
intermediate 10 minutes

Run agents in the background

Once an agent works, you want it running without you opening the app. This guide sets up background execution with device-aware conditions and shows where to review results.

  1. 1

    Attach a schedule or trigger

    Give the agent a time schedule or a condition trigger so it runs on its own in the background.

  2. 2

    Choose device-aware conditions

    Restrict runs to sensible states — on Wi-Fi, while charging, or only when the target app is available — to avoid firing at bad times.

    e.g. run daily at 8am · on Wi-Fi · while charging
  3. 3

    Let it run

    The agent now perceives and acts through the Accessibility Service in the background, without you opening Ukkin.

  4. 4

    Review tracking history

    Open the agent's local tracking history to see what ran and when. Everything is stored on-device.

Keeping background runs reliable

  • Device-aware conditions prevent agents from firing when the target app is not available.
  • Because history is local, you can audit exactly what happened without a cloud dashboard.
  • Local-first is the design intent; verify your build if strict no-cloud operation matters to you.

More guides in the index, or read the architecture to see how agents perceive and act.