Bluma Sign in

Dates, reminders and repeats

A to-do can have a day you plan to start it, a deadline, a reminder and a repeat rule. All four are optional.

When and deadline

An open to-do. Each chip opens its own control.

Open a to-do and choose When or Deadline. Pick Today, This Evening, Tomorrow, Anytime or Someday, or choose Pick a Date… for the calendar.

Type a date in plain words

Matches appear as you type. Return takes the first.

In the When and Deadline controls you can type instead of picking. Matches appear as you type, and Return chooses the first one.

Things you can type
today, tomorrow, tomToday or tomorrow
tonight, eveningToday, under This Evening
fri, fridayThe next Friday
in 3 days, next week, weekendCounted from today
nov 22, 22 novThat date
anytime, somedayNo date

In the terminal, --when takes today, tomorrow, anytime, someday, inbox or a date written 2026-12-01.

Reminders

Open a to-do, choose Reminder, set a date and time, and choose Set Reminder. The row shows a bell with the time. To clear it, open the reminder again and choose Remove.

A reminder keeps its clock time when you travel: 9:00 stays 9:00 in the new time zone.

bluma add "Take out the bins" -w today --evening --remind "today 19:30"

Repeating to-dos

Every 2 weeks, counted from the due date.
  1. Open a to-do and choose Repeat.
  2. Choose how often: every so many days, weeks, months or years.
  3. Choose what it counts from. Due date keeps a fixed rhythm, like rent on the 1st. Completion counts from the day you finish, like a haircut every six weeks.
  4. Choose Set Repeat. The row shows a repeat mark.

When you complete a repeating to-do, the next one is created on its next date with the same notes, tags and checklist, and its deadline and reminder moved along. Canceling a repeating to-do ends the repeat. To stop one, open Repeat and choose Never.

bluma edit 3fk --repeat "every 2 weeks"
bluma edit 3fk --repeat "every 3 days after completion"
bluma edit 3fk --repeat none

Calendar events in Today and Upcoming

iPhoneMac Turn on Show Calendar Events in Settings and allow access. Your events for the day appear at the top of Today and under each day in Upcoming. They are read on the device and never sent to Bluma.

Still stuck?

Email support@bluma.sh and a person will answer. Say what you were doing and which app you were in. For a security problem, write to security@bluma.sh.