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. The one exception is the slip import
link, which brings something in from outside and
therefore always asks first.
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.
Import a community slip#
todebaran://slips/import?slug=<slug>
This is what the Open in Todebaran button on every Community Slips page fires. Todebaran comes to the front and opens an import dialog showing what the slip is, what it does when it runs — shell commands, JavaScript, AI, sites it contacts — and a picker for the folder to put it in. Nothing is added until you confirm.
| Parameter | Value |
|---|---|
slug | The slip's identifier, the last part of its page URL (required) |
Only slips from Community Slips
The link carries a slug, never a file or an address. Todebaran fetches the slip from Community Slips itself, so a link can't point the import at anything else — and because it opens a dialog rather than importing, a link you didn't mean to click costs you a dismissed window.
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.