Skip to content

Scheduled briefings

A briefing is a question Prevail asks on a schedule and delivers the answer to. “What’s new in wealth this week?” every Monday at 7am; “anything urgent in tax?” on the first of the month. The verdict lands in your log, on your phone, or both.

Terminal window
prevail briefing add \
--cron "0 7 * * 1" \
--domain wealth \
--prompt "what's new this week?" \
--mode council \
--deliver telegram
FlagMeaning
--cronStandard cron expression for when to run
--domainWhich domain to ask in (sets the context)
--promptThe question
--modecouncil (full panel) or single (one CLI)
--deliverlog, telegram, or both

The example above fires every Monday at 7am, convenes the wealth council, and sends the verdict to Telegram.

Terminal window
prevail briefing list list all briefings
prevail briefing run <id> run one right now (test it)
prevail briefing remove <id> delete one

You can also manage them from the cockpit with /briefing.

Briefings are stored in <vault>/.briefings.json, so they travel with your vault.

  • log — the verdict is written to the domain’s _log/ like any other turn. You’ll see it next time you open the domain.
  • telegram — the verdict is pushed to your phone. Requires the Telegram bridge set up and the daemon running.
  • both — logged and pushed.

Briefings fire from the daemon, which checks every minute for anything due:

Terminal window
prevail daemon --telegram # polls Telegram AND ticks briefings

Briefings are the high-level, domain-aware scheduler. For arbitrary recurring commands, Prevail also has a general schedule facility backed by <vault>/.schedule.json:

Terminal window
prevail schedule list
prevail schedule add "0 7 * * *" "<command>" --name wealth-7am
prevail schedule remove <id>
prevail schedule run <id>
prevail schedule tick # fire everything due right now (debugging)

Most people only need briefing; reach for schedule when you want to run something that isn’t a domain question.