Skip to main content
Automation

Automate TaskForge with Deep Linking

Automate your Obsidian task management with TaskForge deep linking. Works with Apple Shortcuts, Raycast, Alfred, and any automation tool that supports custom URLs. Create tasks with voice commands, build custom workflows, and integrate TaskForge into your automation ecosystem.

TaskForge deep linking reference on macOS showing URL scheme documentation
View All Features

What Is Deep Linking in TaskForge?

Deep linking allows you to open TaskForge directly to specific screens or actions using custom URL schemes. Instead of launching the app and navigating manually, you can create URLs that jump straight to creating a new task, viewing a specific list, or opening the quick-add dialog.

TaskForge uses the taskforge:/// URL scheme, making it compatible with Apple Shortcuts, other iOS automation tools, and even external apps that support custom URL schemes.

Instant Access

Jump directly to the task creation screen with pre-filled data

Siri Integration

Create tasks using voice commands through Apple Shortcuts

Universal Links

Share task creation links that work across all your devices

What Deep Link Routes Are Available?

New Task

taskforge:///new-task

Opens the task creation screen. Supports query parameters to pre-fill task data.

Parameters:

  • name - Task title
  • tags - Comma-separated tags
  • dueDate - Due date (YYYY-MM-DD)
  • priority - Task priority (highest, high, medium, low, lowest)
  • listId - Target custom list UUID

Example:

taskforge:///new-task?name=Review%20PR&tags=work,urgent&priority=High&dueDate=2025-10-15

Quick Add

taskforge:///quick-add

Opens the quick-add dialog for fast task creation with natural language parsing.

Example:

taskforge:///quick-add

View Custom List

taskforge:///list/:listName

Opens a specific custom list by name. Perfect for creating shortcuts to your most-used lists.

Example:

taskforge:///list/Work%20Tasks

Calendar View

taskforge:///calendar

Opens the calendar view to see your tasks organized by date.

Optional Parameters:

  • date - Jump to specific date (YYYY-MM-DD)

Example:

taskforge:///calendar/2025-10-15

View Task

taskforge:///task/:taskId

Opens a specific task's detail view using its unique task ID.

Example:

taskforge:///task/abc123def456

Home

taskforge:///home

Opens TaskForge to the home screen with your default view.

How Do I Create My First Apple Shortcut?

Example 1: Quick Task Creation with Siri

Create a shortcut that lets you say 'Add task' to Siri and instantly open the TaskForge quick-add dialog.

  1. 1 Open the Shortcuts app on your iPhone or iPad
  2. 2 Tap the + button to create a new shortcut
  3. 3 Search for 'Open URLs' action and add it to your shortcut
  4. 4
    Enter the URL: taskforge:///quick-add
  5. 5 Name your shortcut 'Add Task' and enable 'Show in Share Sheet' if desired
  6. 6 Say 'Hey Siri, Add Task' to instantly open TaskForge's quick-add dialog

Example 2: Pre-filled Task Creation

Create a shortcut that opens the new task screen with pre-filled data for recurring tasks like weekly reviews.

  1. 1 Create a new shortcut in the Shortcuts app
  2. 2 Add the 'Open URLs' action
  3. 3
    Enter a URL with parameters: taskforge:///new-task?name=Weekly%20Review&tags=review,work&priority=High&listId=abc-123-def
  4. 4 Name it 'Create Weekly Review' and run the shortcut

Pro Tip: URL encode special characters (spaces become %20, # becomes %23, etc.)

Example 3: Location-Based Task Reminder

Create a shortcut that creates a task when you arrive at or leave a specific location.

  1. 1 Create a new automation in the Shortcuts app (Automation tab)
  2. 2 Choose 'Arrive' or 'Leave' as the trigger
  3. 3 Select your location (e.g., 'Home' or 'Office')
  4. 4 Add 'Open URLs' action with a TaskForge deep link
  5. 5
    Example for arriving at work: taskforge:///list/Work%20Tasks

What Universal App Integrations Are Supported?

TaskForge's deep linking works with any app or tool that supports custom URL schemes. Here are some popular universal integrations that work across platforms:

Raycast (macOS)

Create custom Raycast commands to quickly add tasks to TaskForge. Use the 'Open URL' action with TaskForge deep links to build powerful keyboard-driven workflows.

taskforge:///new-task?name=Review%20PR&tags=work

Alfred (macOS)

Build Alfred workflows that open TaskForge URLs. Create custom keywords that accept arguments and pass them to TaskForge for instant task creation.

Use Alfred's 'Open URL' action with dynamic arguments

Keyboard Maestro (macOS)

Create macros that trigger TaskForge actions via deep links. Combine with text expansion, clipboard monitoring, or keyboard shortcuts for powerful automation.

Perfect for context-aware task creation workflows

Any Automation Tool

TaskForge deep links work with any tool that can open URLs: Zapier, IFTTT, Hammerspoon, BetterTouchTool, and more. If it can open a URL, it can integrate with TaskForge.

Universal URL scheme compatibility

What Advanced Automation Ideas Can I Try?

Daily Planning Routine

Create a time-based automation that opens your 'Today' custom list every morning at 8 AM to review your daily tasks.

taskforge:///list/Today

Calendar Event to Task

Create a shortcut that converts upcoming calendar events into TaskForge tasks with due dates matching the event time.

Use 'Get Calendar Events' + 'Open URLs' actions

Context Shortcuts

Create multiple shortcuts for different contexts: 'Add Work Task', 'Add Personal Task', 'Add Urgent Task' - each with pre-filled tags and lists.

Perfect for different areas of your life

How Do I Handle URL Encoding?

When creating deep links with query parameters, remember to URL encode special characters:

Space %20
Hash (#) %23
Ampersand (&) %26
Comma (,) %2C
Forward slash (/) %2F

Pro Tip: In the Shortcuts app, you can use the 'URL Encode' action to automatically encode text before passing it to the 'Open URLs' action.

Frequently Asked Questions About Deep Linking

Does deep linking work on Android?

Yes. TaskForge supports the same taskforge:/// URL scheme on Android. You can use Tasker, Automate, MacroDroid, or any other Android automation app that supports opening custom URLs. The available routes and parameters are identical across platforms.

Can I use deep links in Obsidian notes?

Yes. Add a TaskForge deep link as a standard markdown link in any Obsidian note. When you click the link, your device opens TaskForge and navigates to the specified screen. This is a great way to connect project notes directly to task creation or specific task lists.

Do deep links work when the app is closed?

Yes. The taskforge:/// URL scheme launches TaskForge if it is not already running and then navigates to the target screen. There is no need to have the app open in the background. The system handles launching the app and passing the URL automatically.

Can I create deep links with variables?

Yes. In Apple Shortcuts, use Shortcuts variables to build URLs dynamically. For example, you can pass clipboard contents as the task name or use the current date as the due date. In Raycast, use script arguments. In Tasker on Android, use Tasker variables. Any automation tool that supports string interpolation can build dynamic deep links.

What happens if a list name in a deep link does not exist?

If the list name in a deep link does not match any of your custom lists, TaskForge opens to the home screen and displays an error message letting you know the list was not found. The app does not crash or hang. Double-check your list names and URL encoding if this happens.

Ready to Automate Your Task Management?

Download TaskForge today and start building powerful automation workflows with Apple Shortcuts and deep linking. Explore TaskForge on iPhone and Mac , or browse our full feature list to learn more.

Have questions? Check our FAQ or contact us

Azhar Dewji
Azhar Dewji · · Updated March 14, 2026

Software engineer with 10+ years of experience building mobile and desktop apps in Swift, Kotlin, and Flutter. Indie developer based in Toronto, Canada. Creator of TaskForge. Learn more