Automation

Pinwork fits into the Apple workflows you already use: Siri, Shortcuts, keyboard shortcuts, URL schemes, AppleScript, Focus Filters, and automation apps.

Some automation opens Pinwork to the right place. Some creates or changes tasks. Anything that changes task data is blocked when access is locked.

Siri and Shortcuts

Pinwork registers App Shortcuts for:

• Quick Add
• Show Today
• Show Inbox
• Show Upcoming

The navigation shortcuts open Pinwork, store the requested destination, and the main app consumes that destination when it launches or returns to foreground.

Navigation targets expire quickly. If the app does not consume a pending target within about 30 seconds, it is ignored.

Navigation shortcuts are also ignored while first-run navigation is locked.

Quick Add from Siri or Shortcuts

The Quick Add App Intent accepts a title and queues a task creation request.

Siri phrases include:

• Add a task in Pinwork
• New task in Pinwork
• Capture in Pinwork
• Quick add in Pinwork
• Add to Pinwork

This path captures raw text. Pinwork’s natural-language parser does not run. Dates, tags, project syntax, recurrence, and calendar commands stay in the title.

Shortcut Quick Add is raw text

Use pinwork://quickadd or AppleScript quick add when your automation needs natural-language parsing applied at capture time.

The queued task is created in your default Quick Add destination: Inbox, Today, or Tomorrow.

Quick Add through App Intents requires shared Pro access. If access is missing, Pinwork asks you to open the app to restore access.

Complete a task from Shortcuts

The Complete Task App Intent lets Shortcuts complete a task without opening the main app.

It uses Pinwork’s task picker. The picker can suggest incomplete tasks from the widget snapshot or the broader intent task index. Search matches task titles.

The task index includes non-terminal tasks, so Waiting and Someday/Maybe tasks can appear if they are incomplete.

Shortcuts can complete tasks, but reopening a completed task is handled through the app UI, widgets, Watch, deep links, or AppleScript.

Deep links

Pinwork supports the pinwork:// URL scheme.

Navigation links open app surfaces:

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

Other links can open a task, project, focus session, or search with a prefilled query and scope.

Task mutation links include:

pinwork://quickadd?text=...
pinwork://add?title=...
pinwork://complete/{id}
pinwork://uncomplete/{id}
pinwork://defer/{id}?to=...
pinwork://reschedule/{id}?date=...
pinwork://archive/{id}
pinwork://delete/{id}

pinwork://quickadd?text=... creates a task in the background and parses natural language.

pinwork://add?... creates or opens a task from explicit parameters such as title, when, deadline, list, project, tags, notes, or estimate.

Archive and delete links show confirmation because they are destructive external actions.

External destructive links ask first

Archive and delete links show confirmation because they can change or remove data from outside the normal app UI.

AppleScript on Mac

Pinwork exposes scriptable tasks, projects, and tags on Mac.

Example:

tell application "Pinwork"
    set todayTasks to today tasks
    quick add "Call mom tomorrow at 3pm"
end tell

AppleScript commands include:

• complete
• uncomplete
• defer
• reschedule
• archive
• quick add
• search tasks
• today tasks
• inbox tasks

Data commands are also available for surfaces such as inbox, today, all tasks, search, projects, and tags.

AppleScript quick add uses the same natural-language quick-add service as pinwork://quickadd.

Mutation commands are blocked when access is locked and request the access screen. Read commands can still inspect data.

Get task IDs from search or Copy Task Link

AppleScript mutation commands need a task ID. Use search tasks to find a task and read its ID, or use Copy Task Link from the task menu to get a stable link that contains the ID.

Keyboard shortcuts

Keyboard shortcuts are available on Mac and iPad with a hardware keyboard.

Use Command-K for the command palette, Command-N for a new task, and Command-F for search.

For the full list, see Keyboard shortcuts.

Command palette

Press Command-K on Mac or iPad to open the command palette.

Commands include:

• New Task
• Search
• Toggle Sidebar
• Today
• Upcoming
• Inbox
• Projects
• All Tasks
• Archive
• Open Task in New Window
• Open Project in New Window
• Settings
• Refresh

Task-specific shortcut rows can appear as informational rows because they need a task context and are not executed directly from the palette.

Task menu commands on Mac

The Mac Task menu exposes focused-task commands such as:

• Cycle Status
• Mark as Done
• In Progress
• Not Started
• Waiting
• Someday/Maybe
• Canceled
• Defer Today
• Defer Tomorrow
• Remove Schedule
• Snooze
• Duplicate
• Copy Task Link
• Edit Task
• Delete Task

Command-modified shortcuts are registered in the menu. Bare-letter shortcuts are handled by the task list instead of the menu so text fields remain usable.

Focus Filters

On iPhone and iPad, Pinwork can be used as a system Focus Filter.

In System Settings, open Focus, choose a Focus, add a Pinwork Focus Filter, and choose the default view:

• Today
• Inbox
• Upcoming
• All Tasks

When that Focus activates, Pinwork stores the chosen view and the main app navigates there when it receives the Focus state. Stale Focus Filter configs are ignored after 24 hours, repeated navigation to the same view is avoided, and the state clears when the Focus deactivates.

Access lock behavior

Automation that reads or opens Pinwork can continue when access is locked.

Automation that creates, completes, deletes, defers, reschedules, archives, or otherwise changes task data is blocked until access is restored.

Related

• Capturing tasks: which capture paths parse natural language.
• Natural language: syntax and parser boundaries.
• Working with tasks: the task actions used by shortcuts, deep links, and scripts.