Skip to content

URL Scheme

Deep link into Taskdn Desktop from external tools like Alfred, Raycast, Obsidian, or browser bookmarks.

Command Purpose
taskdn://open Open an entity or navigate to a view
taskdn://new Create a new task

Opens an existing task, project, area, or navigates to a view.

taskdn://open?path=<url-encoded-path>
Parameter Required Description
path Yes URL-encoded absolute path to a .md file

Where the entity opens:

Entity Type Navigation
Task (inbox) Inbox view, task selected
Task (in project) Project view, task selected
Task (in area, no project) Area view, task selected
Task (orphan) No Area view, task selected
Project Project view
Area Area view

Examples:

taskdn://open?path=%2FUsers%2Fdanny%2Fnotes%2Ftasks%2Fmy-task.md
taskdn://open?path=%2FUsers%2Fdanny%2Fnotes%2Fprojects%2Fwebsite.md
taskdn://open?view=<view-name>
Parameter Required Description
view Yes View identifier (lowercase, kebab-case)

Supported views:

View Description
today Today view
this-week This Week view
inbox Inbox view
calendar Calendar view
no-area No Area view (orphan tasks/projects)

Examples:

taskdn://open?view=today
taskdn://open?view=inbox

Creates a new task and opens it for editing.

taskdn://new?title=<title>&status=<status>&...
Parameter Required Format Description
title No URL-encoded string Task title (default: “New Task”)
status No Lowercase kebab-case Task status (default: inbox)
due No YYYY-MM-DD Due date
scheduled No YYYY-MM-DD Scheduled date
defer-until No YYYY-MM-DD Defer until date
project No URL-encoded string Project title (case-insensitive match)
area No URL-encoded string Area title (case-insensitive match)
body No URL-encoded string Task notes (Markdown, newlines)

Valid status values:

  • inbox (default)
  • icebox
  • ready
  • in-progress
  • blocked
  • dropped
  • done

Behavior:

  1. Creates the task with provided parameters
  2. Navigates to appropriate view
  3. Opens detail panel with title field focused

Examples:

# Simple inbox task
taskdn://new?title=Buy%20groceries
# Task with project
taskdn://new?title=Update%20homepage&project=Website%20Redesign
# Task with dates
taskdn://new?title=Review%20PR&due=2025-01-20&scheduled=2025-01-15
# Task with body content
taskdn://new?title=Meeting%20notes&body=Discussed%3A%0A-%20Budget%0A-%20Timeline
# Minimal (creates "New Task" in inbox)
taskdn://new

Project/Area matching:

  • Case-insensitive title match
  • First match wins if duplicates exist
  • Unmatched values are silently ignored

  • Valid URLs: App comes to foreground
  • Invalid URLs: App stays in background (silent failure)

All parameter values must be URL-encoded:

Character Encoded
Space %20
Newline %0A
/ %2F
? %3F
& %26
= %3D

Create a workflow that runs:

open "taskdn://new?title={query}"

Link to a task from your notes:

[Open task](taskdn://open?path=%2FUsers%2Fdanny%2Fnotes%2Ftasks%2Fmy-task.md)
# Quick capture
open "taskdn://new?title=$(echo "$1" | jq -sRr @uri)"