Bluma Sign in

Your to-do list, from the terminal

Bluma has a REST API that every account can use today, and a bluma command built on it. Both work on the same lists as the Mac, iPhone and web apps.

Open in browserRead the API guide

What you can use today

Install

brew install arnenoori/bluma/bluma        # Homebrew
npm install -g bluma-cli                  # npm (or try it: npx bluma-cli today)
curl -fsSL https://bluma.sh/install.sh | sh

bluma login

Each one installs the same self-contained bluma program for Apple silicon, Intel and ARM. The script checks the download against its published checksum.

The REST API

curl https://api.bluma.sh/v1/tasks?view=today \
  -H "Authorization: Bearer blm_…"

curl -X POST https://api.bluma.sh/v1/tasks \
  -H "Authorization: Bearer blm_…" -H "content-type: application/json" \
  -d '{"title": "Renew passport", "when": "tomorrow", "deadline": "2027-01-15"}'

The bluma command

Short commands, plain output, and JSON when a script asks for it.
bluma add "Call mum" -w today --evening -r "today 18:30"
bluma add "Water the plants" --repeat "every 3 days after completion"
bluma today                 # also: inbox, upcoming, anytime, someday, logbook, trash
bluma list -p website -q copy
bluma done 3fk              # any unique id prefix works
bluma edit 3fk -w someday -p none
bluma today --json          # every command can print JSON

Questions

How do I install the bluma command?

With Homebrew, npm or the install script: see Install above. It is one self-contained program, with nothing else to set up.

Is the API rate limited?

There is no published limit. As the terms say, automated use that degrades the service for others may be limited.

Does the API cost anything?

No. Bluma is free to use today, including the API. There is no paid plan.