Getting started
Bluma keeps one set of lists on your Mac, your iPhone, the web and in the tools your agents use. Five minutes gets you set up.
Get the apps
- Mac: download Bluma for Mac, open the disk image and drag Bluma to Applications. It needs macOS 15 or later.
- Web: open app.bluma.sh in any modern browser. There is nothing to install.
- iPhone and iPad: the app is in beta and not on the App Store yet.
- Terminal and agents: see Agents, the CLI and the API.
Make an account
- Open Bluma. Choose Continue with Apple, or type your email and a password of at least 8 characters.
- If there is no account for that email yet, Bluma offers to create one. Choose Create account.
- With an email account, open the link we send to confirm your address. Nothing is locked while you wait.
Use the same sign-in on every device. Your lists appear as soon as you are in.
Add your first to-do
- Renew passport
- Book the dentist
- iPhone Tap the round + button. On the home screen it also offers New Project and New Area.
- Mac Press ⌘N.
- Web Press N, or click New To-Do at the top of the list.
The new to-do opens as a card with the title ready to type. Notes, a date, a deadline, tags, a checklist, a reminder and a repeat are all right there. Close the card and it is saved; a card with nothing in it is thrown away.
Finish it
Click or tap the round checkbox. It fills violet, and the to-do moves to the Logbook. A small Completed · Undo message stays for a few seconds in case that was a mistake.
Where next
- Learn what each list is for, including Today and This Evening.
- Bring your to-dos over from Things, Todoist or Apple Reminders.
- Connect an agent so Claude Code or a script can add and finish to-dos for you.
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.