Deep links

Pinwork supports the pinwork:// URL scheme for navigation, capture, task opening, and automation.

Deep links work from Shortcuts, Raycast, Alfred, Keyboard Maestro, shell scripts, AppleScript, browser bookmarks, and any other tool that can open a URL.

Raycast extension

If you use Raycast, the dedicated Pinwork extension is the quickest way to work with your tasks. It gives you ready-made commands for common actions, so you do not have to build pinwork:// URLs by hand.

Install it from the Raycast Store: Pinwork on the Raycast Store.

The extension includes commands to show Today, Inbox, and Next, quick add a task with natural language, search tasks, and show projects.

You can still use the raw pinwork:// links below from Raycast when you want an action the extension does not cover.

Navigation links open Pinwork to a list or section:

pinwork://today
pinwork://inbox
pinwork://next
pinwork://later
pinwork://someday
pinwork://waiting
pinwork://archive

Navigation links do not change task data.

Quick add

Use pinwork://quickadd to create a task from natural language:

pinwork://quickadd?text=Review%20pitch%20deck%20Friday%20at%202pm%20%23startup

Quick add runs Pinwork’s natural-language parser. It can apply recognized dates, times, tags, projects, recurrence phrases, estimates, and calendar commands.

This is different from the Siri or Shortcuts Quick Add App Intent, which captures raw text.

Add with explicit parameters

Use pinwork://add when automation already knows the fields and wants to pass explicit parameters.

Examples of supported concepts include:

title
notes
When
Deadline
list or destination
project
tags
estimate

The add flow can create or open a task for review depending on the parameters and platform flow.

Open tasks and projects

Pinwork can open task and project deep links created by the app, such as links copied from task actions.

Use Copy Task Link from a task menu or shortcut when you want a stable link to paste into notes, scripts, or automation tools.

If the target item is missing or no longer available, Pinwork cannot open it.

Complete and uncomplete

Task mutation links can complete or reopen tasks:

pinwork://complete/{id}
pinwork://uncomplete/{id}

Complete uses Pinwork’s task completion path and can create a next occurrence for a recurring task when the recurrence rule allows one.

Uncomplete reopens the task to Not Started.

Defer and reschedule

Use defer or reschedule links to change a task’s When date:

pinwork://defer/{id}?to=tomorrow
pinwork://reschedule/{id}?date=2026-06-15

Defer supports preset targets. Reschedule supports a specific date and optional time.

Use these links carefully in automation because they change task data without the normal list gesture flow.

Archive and delete

Destructive links are supported:

pinwork://archive/{id}
pinwork://delete/{id}

Archive marks the task canceled. Delete permanently deletes the task.

Pinwork shows confirmation for archive and delete links because they can be triggered from outside the normal app UI.

Undo behavior

Background deep-link mutations do not provide the normal in-app undo stack.

If you need the normal undo experience, use the in-app task actions instead of a background mutation link.

Access lock behavior

Links that open Pinwork or navigate can still work when access is locked.

Links that create, complete, uncomplete, defer, reschedule, archive, or delete tasks are blocked until access is restored.

Natural language: syntax used by quick add.
Automation: Shortcuts, AppleScript, and command palette.
Archive, delete, restore, and undo: consequences of destructive actions.

Was this page helpful?