Example Plans

The following are actually trigger examples. A plan must have at least one desc and one trigger.

Day

Every day

  every: day

Every 16 days

  every: 16d

Starting from 2026-03-10, every 16 days

  from: 2026-3-10
  every: 16d

Week

Every Saturday

  every: Sat

Every Saturday and Sunday

  every: [Sat, Sun]

Every eight weeks on Saturday

  every: 8week
  on: Sat

Month

The 1st of every month

  every: 1

Every day in June

  every: June

The first Monday of every month

  every: month
  on: Monday

The last Saturday of every month

  every: month
  last: Sat

The second-to-last Saturday of every month

  every: month
  last: 2Sat

The last Saturday of every 3 months

  every: 3month
  last: Sat

The 29th of every month (falls on the last day if the month has no 29th)

  every: month
  on: 29d

Year

Not yet supported for specifying an entire year

June 1st every year

  every: 6-1

The last Saturday of every year

  every: year
  last: Sat

The 10th-to-last day of every year

  every: year
  last: 10day

When

Take a shower after every workout

- desc: Workout
  every: [Mon, Wed, Sat]
  tag: workout

- desc: Shower
  if: workout

Remind me 3 days before a birthday

- desc: ...
  every: 1-11
  tag: birthday

- desc: Someone's birthday is approaching
  if: birthday
  before: 3d

Black Friday is the day after Thanksgiving

- desc: Thanksgiving is the fourth Thursday of November
  every: November
  on: 4Thur
  tag: thanksgiving

- desc: Black Friday
  if: thanksgiving
  after: 1d

Combination

Mid-June and mid-December

  trigger:
  - every: June
    on: 15
  - every: December
    on: 15
  match: any

The first Saturday of every month from June to September

  trigger:
  - every: [June, July, August, September]
  - every: month
    on: Sat
  match: all

Lunar Calendar

Lunar June 1st

  every: 农历6-12