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.
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 Open the Shortcuts app on your iPhone or iPad
- 2 Tap the + button to create a new shortcut
- 3 Search for 'Open URLs' action and add it to your shortcut
- 4 Enter the URL:
taskforge:///quick-add - 5 Name your shortcut 'Add Task' and enable 'Show in Share Sheet' if desired
- 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 Create a new shortcut in the Shortcuts app
- 2 Add the 'Open URLs' action
- 3 Enter a URL with parameters:
taskforge:///new-task?name=Weekly%20Review&tags=review,work&priority=High&listId=abc-123-def - 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 Create a new automation in the Shortcuts app (Automation tab)
- 2 Choose 'Arrive' or 'Leave' as the trigger
- 3 Select your location (e.g., 'Home' or 'Office')
- 4 Add 'Open URLs' action with a TaskForge deep link
- 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:
%20 %23 %26 %2C %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?
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?
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?
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?
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?
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
Related Articles
- Interactive Widgets for Task Management Complete tasks directly from your home screen with fully interactive widgets on iOS, iPadOS, and Android. Read more
- Smart Notifications for Obsidian Tasks Configure task reminders and due date alerts that work across all your devices. Read more
- Obsidian Task Widgets Guide Set up and customize home screen widgets for quick access to your Obsidian tasks. Read more
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