Skip to content

Scheduling

One background item, memcal, appears in System Settings → Login Items & Extensions. The installer builds a small local app wrapper so macOS attributes Calendar access to memcal instead of Python; if that build is unavailable, the named script remains the fallback. launchd starts it at 03:00, at login, and every 30 minutes; an interval that elapsed while the machine slept fires on wake.

memcal schedule install    # daily + catch-up launchd job
memcal schedule status     # loaded/at/next/last-pass/outcome
memcal schedule            # when the pass last ran, whether one is owed
memcal schedule run        # run now regardless
memcal schedule due        # just the answer

Each run asks whether the day's pass is owed:

  • Owed — collect from every source, then run the extraction pass. A laptop shut or asleep at 03:00 runs one catch-up pass when the lid opens.
  • Not owed — collect only from sources that are behind and reachable right now. Cheap, and it cannot cost a model call, which is why it is safe on every wake-up.

Daytime collection between passes is model-free; dream stays nightly. See Daytime freshness and Dream.