Guides

Deep links

Trigger Todebaran from a link — capture tasks and jump to views with the todebaran:// URL scheme.

Todebaran registers a todebaran:// URL scheme, so a plain link can drive the app: create a task, project, tag or slip, or jump straight to a view. Fire one from another app, a browser bookmark, a launcher like Raycast, Alfred or macOS Shortcuts, your terminal, or your own notes.

The format#

todebaran://<entity>/<action>?<parameters>

Parameter values must be URL-encoded — spaces become %20, and so on.

Add and navigate only — by design

Deep links can create things and move around the app, but they can never edit, complete or delete anything. Any web page you visit can fire a todebaran:// link, and these run without a confirmation — so Todebaran only allows actions that add something you can see, never ones that change data behind your back.

Create a task#

todebaran://tasks/add?name=Buy%20milk

The new task lands in your Inbox. Add parameters to fill it out:

Parameter	Value
`name`	The task title (required)
`startDate`	A date as `YYYY-MM-DD`, or `someday`
`deadline`	A date as `YYYY-MM-DD`
`content`	Note text
`projectId` / `collectionId`	Put the task straight into a project or collection (advanced — needs the item's id)

For example, a task scheduled for a day with a deadline the next:

todebaran://tasks/add?name=Call%20the%20vet&startDate=2026-07-25&deadline=2026-07-26

Create a project, tag or slip#

todebaran://projects/add?name=Kitchen%20remodel
todebaran://tags/add?name=errand
todebaran://slips/add?name=Order%20ticket&folderId=<slip-folder-id>

Link	Parameters
`projects/add`	`name` (required), `parentId` (an area, shared space or parent project — optional)
`tags/add`	`name` (required)
`slips/add`	`name` (required), `folderId` (the parent slip folder — required)

Parameters ending in Id — projectId, collectionId, parentId, folderId — refer to a specific item by its internal id. They're for advanced automation; most links just pass a name and let the item land in the default place.

Jump to a view#

todebaran://navigate?path=/inbox

Path	Opens
`/`	Today
`/inbox`	Inbox
`/tomorrow`	Tomorrow
`/upcoming`	Upcoming
`/someday`	Someday
`/calendar`	Calendar
`/completed`	Completed
`/trash`	Trash
`/slips`	Slips

You can also target a specific item by id — /projects/<id>, /collection/<id> or /smart-lists/<id>.

Firing a link#

Anywhere a link can live works:

Terminal — open "todebaran://tasks/add?name=Buy%20milk"
Bookmark — save the URL as a browser bookmark for one-click capture.
Launchers — Raycast, Alfred or macOS Shortcuts can open a todebaran:// URL, so you can wire capture to a hotkey or a Shortcut.
Notes and docs — paste a link anywhere clickable.

A macOS Shortcut that opens todebaran://tasks/add?name=… gives you a system-wide capture action you can trigger by voice or hotkey — a nice companion to Quick Add.