Skip to content
Rival Docs

Rituals & Schedules

Overview

A Ritual (also called a Schedule) is a scheduled, autonomous run of your agent. You give it a prompt and a schedule; the agent then runs that prompt on its own at the configured times, without anyone in the chat.

Rituals are the way to automate recurring work - a morning email summary, an hourly status check, a Monday-morning weekly report.

Creating a Ritual

  1. Open the agent’s editor.
  2. Go to the Rituals section.
  3. Click New ritual. The Config modal opens.
  4. Fill in:
    • Name - what this ritual does (e.g. Morning inbox digest).
    • Prompt - the exact message the agent will receive at every scheduled run.
    • Schedule - when to run (cron-style - see below).
  5. Save.

The ritual appears in the list. It can be enabled, disabled, edited, or deleted at any time.

Schedule

The schedule field accepts cron-style expressions, so you can express things like every weekday at 9:00 AM, every hour, first day of the month, and so on. Configure the schedule in the time zone the modal shows you so you don’t get caught out by UTC offsets.

Typical schedules:

  • Daily morning digest - once a day at a fixed time.
  • Hourly check - every hour, on the hour.
  • Weekly report - once a week on the chosen weekday and time.

Schedule Logs

Every ritual run is recorded under Schedule Logs, visible from the ritual’s row in the editor. Each log entry shows:

  • Timestamp of the run
  • Status - Success or Failed
  • A preview of the output
  • The full transcript when expanded
  • The error message for failed runs

Schedule Logs are the first place to look when a ritual misbehaves - open the most recent failed entry to see what went wrong.

Use cases

  • Daily briefing - “Summarize my unread emails from overnight, group by sender, and call out anything that mentions me by name.”
  • Hourly status check - “Check status.example.com. If any service is degraded, post a Slack message in #ops.”
  • Weekly report - “Pull this week’s deal pipeline from the CRM and write a one-page summary of changes since last week.”
  • Monthly cleanup - “List Google Drive files in /Shared older than 12 months that haven’t been opened, and email me the list.”

Guardrails and Rituals

Rituals run with the agent’s full Persona & Guardrails applied - but with one important difference: there’s no human in the chat to approve anything. Actions marked Needs approval are skipped during a ritual run, and a note is added to the schedule log explaining what was skipped.

If a ritual needs to send emails or take other approval-gated actions, mark those actions as Allowed on the agent - not Needs approval - before relying on the ritual.

Next steps