AppleScript

Pinwork exposes AppleScript on Mac for automating task capture, search, and task actions from Script Editor, osascript, Raycast, Alfred, Keyboard Maestro, shell scripts, or other Mac automation tools.

AppleScript can read tasks, projects, and tags. It can also run selected task mutations when access is active.

Quick add

Use quick add to create a task from natural language:

tell application "Pinwork"
    quick add "Review pitch deck Friday at 2pm #startup"
end tell

AppleScript quick add uses the same background quick-add service as pinwork://quickadd, so Pinwork parses supported natural-language metadata.

That can include dates, times, tags, project tokens, recurrence phrases, estimates, and calendar commands.

Read Today and Inbox

AppleScript can read task lists:

tell application "Pinwork"
    set todaysTasks to today tasks
    set inboxItems to inbox tasks
end tell

Read commands are useful for scripts that create reports, route tasks to other tools, or inspect the current task state.

Search tasks

Use search commands to find matching tasks:

tell application "Pinwork"
    set matches to search tasks "invoice"
end tell

Search reads Pinwork data and does not change tasks.

Use search to look up task IDs

Mutation commands need a task ID. Run search tasks to find a task by title and inspect its ID before calling complete, defer, reschedule, or archive.

Complete and uncomplete

AppleScript commands can complete or reopen tasks:

tell application "Pinwork"
    complete task id "TASK-ID"
    uncomplete task id "TASK-ID"
end tell

Completion uses Pinwork task behavior. For recurring tasks, normal recurrence rules can apply.

Reopening sets the task back to an active state.

Defer and reschedule

AppleScript can move a task’s When date:

tell application "Pinwork"
    defer task id "TASK-ID" to "tomorrow"
    reschedule task id "TASK-ID" to "2026-06-15"
end tell

Use defer for preset-style movement and reschedule for explicit dates.

Archive

AppleScript can archive a task:

tell application "Pinwork"
    archive task id "TASK-ID"
end tell

Archive marks the task canceled. Use app UI restore flows if you need to bring an archived task back later.

Projects and tags

The scripting dictionary exposes task, project, and tag classes.

Data commands are available for:

• inbox
• today
• all tasks
• search
• projects
• tags

Use these when an automation needs to inspect Pinwork structure before deciding what to do.

Undo behavior

AppleScript mutation commands do not provide the normal in-app undo stack.

Use the app UI for changes where you need immediate user-facing undo.

Read-only access behavior

When access is locked:

• read commands can still inspect data
• mutation commands are blocked
• Pinwork requests the access screen

This applies to quick add, complete, uncomplete, defer, reschedule, and archive.

Read scripts can still work

Read-only recovery blocks scripts that change data. Scripts that only inspect tasks, projects, or tags can continue.

Related

• Deep links: URL automation that works across more tools.
• Natural language: syntax used by quick add.
• Read-only recovery: what happens when access is interrupted.