タスクを自動化する ディープリンク
taskforge:/// URLスキームを使って、あらゆるアプリからタスクの作成、リストの表示、TaskForgeへのナビゲーションが可能です。Obsidian、Apple ショートカット、Raycast、Alfred、Tasker、カスタムURL対応のあらゆるツールと連携できます。
TaskForgeはすべてのプラットフォームでtaskforge://カスタムURLスキームを登録します。ディープリンクはスラッシュ3つ（///）を使用し、iOS、Android、macOS、Windowsで動作します。
taskforge:///[path]?[parameters] スラッシュが3つ（///）であることに注意してください。これはすべてのプラットフォーム共通の形式です。
利用可能なルート
TaskForgeは以下のナビゲーションルートに対応しています。各ルートはアプリ内の特定の画面を開きます。
ホーム
ホーム画面を開きます。
taskforge:/// または taskforge:///home スペース
指定した名前のスペースを開きます。名前はパスパラメータであり、URLエンコードが必要です。従来のtaskforge:///list/プレフィックスも非推奨のエイリアスとして引き続き機能するため、以前のリンクもそのまま使えます。
taskforge:///space/My%20Space タグ別タスク
特定のタグが付いたすべてのタスクを開きます。タグはパスパラメータであり、URLエンコードが必要です。
taskforge:///tag/urgent コンテキスト別タスク
特定のコンテキストを持つすべてのタスクを開きます。コンテキストはパスパラメータであり、URLエンコードが必要です。
taskforge:///context/home プロジェクト別タスク
特定のプロジェクトに含まれるすべてのタスクを開きます。プロジェクトはパスパラメータであり、URLエンコードが必要です。
taskforge:///project/Website タスク詳細
指定したIDのタスクを開きます。タスクのディープリンクは、タスク詳細画面のリンクアイコンをタップして取得できます。IDはタスクのタイトルとファイルから生成されるため、後でタスクの名前を変更したりファイルを移動したりすると、保存していたタスクのリンクは開けなくなります。編集後は新しいリンクを取得してください。
taskforge:///task/abc123def456 ノート
保管庫相対パスで指定したノートを開きます。パスはクエリパラメータで、URLエンコードが必要です。ネストされたノートのスラッシュも含みます。不明なパスや存在しないパスでもエラーにはならず、代わりにノートブラウザが開きます。
taskforge:///note?path=Projects%2FMy%20Note.md 今日のノート
今日のデイリーノートを開きます。まだ存在しない場合は、設定したテンプレートから先に作成します。
taskforge:///daily-note 新規ノート
ノートエディタを開いて、新しい空白のノートを作成します。
taskforge:///new-note カレンダー
カレンダービューを開きます。オプションでYYYY-MM-DD形式の日付をパスセグメントとして指定できます。
taskforge:///calendar または taskforge:///calendar/2025-03-15 クイック追加
自然言語解析対応のクイック追加ダイアログを開きます。オプションで?listId=uuidを付けて特定のリストを指定できます。
taskforge:///quick-add 新規タスク
新規タスク画面を開きます。クエリパラメータでフィールドを事前入力できます（下記のパラメータリファレンスを参照）。
taskforge:///new-task 検索
検索バーに入力できる状態で、ホーム画面を開きます。
taskforge:///?search=true 設定
設定画面を開きます。
taskforge:///settings ディープリンクリファレンス
アプリ内のディープリンクリファレンス画面を開き、対応する全ルートを表示します。
taskforge:///settings/deep-links 新規タスクのパラメータ
/new-taskルートは以下のクエリパラメータを受け付けます。パラメータはすべて省略できます。省略した項目には、設定済みのデフォルト値が使われます。
タスクプロパティ
| パラメータ | フォーマット | 例 | 説明 |
|---|---|---|---|
name | URLエンコード文字列 | name=Buy%20groceries | タスクのタイトル |
tags | カンマ区切り | tags=work,urgent | タスクのタグ |
contexts | カンマ区切り | contexts=home,office | タスクのコンテキスト |
projects | カンマ区切り | projects=Website,Mobile | タスクのプロジェクト |
listId | UUID文字列 | listId=abc-123-def | カスタムスペースに割り当て |
日付 (ISO 8601: YYYY-MM-DD)
| パラメータ | 例 | 説明 |
|---|---|---|
dueDate | dueDate=2025-03-15 | 期限日 |
scheduledDate | scheduledDate=2025-03-10 | 予定日 |
startDate | startDate=2025-03-01 | 開始日 |
completedDate | completedDate=2025-03-20 | 完了日 |
優先度
値は大文字と小文字を区別しません。
Highest, High, Medium, Low, Lowest, None ステータス
値は大文字と小文字を区別しません。
todo, done, cancelled, inProgress, onHold, planned, deferred, blocked, someday, ready 完了時の動作
タスク完了時の動作を指定します。値は大文字と小文字を区別しません。
keep, delete, archive デフォルト設定を適用しない
値を指定しなくても、特定のデフォルト設定を外せます。自動化で空のタスクを作りたいときに便利です。
_skipTags=1 _skipDueDate=1 _skipScheduledDate=1 _skipStartDate=1 _skipDueTime=1 _skipPriority=1 _skipStatus=1 _skipReminders=1 _skipOnCompletion=1 _skipContexts=1 _skipProjects=1 _skipScheduledTime=1 _skipStartTime=1 _skipDuration=1 使用例
期限付きのシンプルなタスク
taskforge:///new-task?name=Buy%20groceries&dueDate=2025-03-15 タグ、優先度、時刻付きの仕事タスク
taskforge:///new-task?name=Review%20PR&tags=work,code-review&priority=High&dueDate=2025-03-15&dueAt=10:00 毎週繰り返すタスク
taskforge:///new-task?name=Team%20Standup&recurrenceInterval=1&recurrenceUnit=week&recurrenceWeekdays=1&dueAt=09:30 すべてのデフォルトを抑制したタスク
taskforge:///new-task?name=Quick%20Note&_skipTags=1&_skipDueDate=1&_skipPriority=1&_skipReminders=1 カスタムスペースに割り当てたタスク
taskforge:///new-task?name=Sprint%20Task&listId=abc-123-def&tags=sprint&priority=Medium 特定の日付でカレンダーを開く
taskforge:///calendar/2025-12-25 特定のリストにクイック追加
taskforge:///quick-add?listId=abc-123-def 保管庫内のパスでノートを開く
taskforge:///note?path=Projects%2FMy%20Note.md 今日のノートに移動する（なければ作成）
taskforge:///daily-note Obsidianでのディープリンク
ObsidianはMarkdownリンクでカスタムURLスキームに対応しており、TaskForgeのディープリンクと最適な組み合わせです。ノートにクリック可能なリンクを追加して、タスクの作成、リストの表示、TaskForgeの特定のビューへの直接ナビゲーションが可能です。
ノート内のMarkdownリンク
Obsidianのノートで標準的なMarkdownリンク構文を使って、クリック可能なディープリンクを作成します：
会議メモからフォローアップタスクを作成
[Add follow-up task](taskforge:///new-task?name=Follow%20up%20on%20meeting&tags=work&dueDate=2025-03-20) 仕事リストへのクイックリンク
[Open Work Tasks](taskforge:///space/Work%20Tasks) 今日のカレンダービューを開く
[Today's Calendar](taskforge:///calendar/2025-03-15) 自然言語でクイック追加
[Quick Add Task](taskforge:///quick-add) Obsidianワークフローのアイデア
ミーティングノートのテンプレート
会議メモテンプレートの末尾にディープリンクボタンを追加しましょう。各会議の後、クリックするだけでタグや期限が事前入力されたフォローアップタスクを作成できます。
プロジェクトダッシュボード
Obsidianのノートをプロジェクトダッシュボードとして活用しましょう。対応するTaskForgeリストを開いたり、新しいプロジェクトタスクを作成したり、プロジェクトの期限をカレンダーで確認するリンクを追加できます。
デイリーノート連携
デイリーノートテンプレートにディープリンクを追加しましょう。今日のリストを開くリンク、アイデアを記録するクイック追加、スケジュール確認用のカレンダービューを含めることができます。
週次レビューのテンプレート
週次レビューのテンプレートにディープリンクを入れておきましょう。来週の繰り返しタスクの作成、レビュー用リストの表示、計画用のカレンダー表示がワンクリックでできます。
他のアプリとの連携
TaskForgeのディープリンクは、カスタムURLスキームを開けるあらゆるアプリやツールで動作します。各プラットフォームでの主要な連携方法をご紹介します。
Apple ショートカット (iOS / macOS)
ショートカットアプリで強力な自動化を作成しましょう。「URLを開く」アクションとTaskForgeのディープリンクを使って、Siriでタスクを作成したり、時間ベースの自動化を実行したり、位置情報連動のワークフローを構築できます。
「URLを開く」アクションを追加し、URLをtaskforge:///new-task?name=My%20Task&tags=work&priority=Highに設定します。ショートカットに名前を付けて、「Hey Siri、[ショートカット名]」でトリガーできます。
ショートカットの変数と組み合わせて、クリップボードの内容、カレンダーの予定、ユーザー入力からタスク名を動的に生成できます。
Raycast (macOS)
TaskForgeでタスクを作成するカスタムRaycastコマンドを構築しましょう。ディープリンクと"Open URL"アクションを使って、現在のアプリを離れずにキーボード操作でタスクを作成できます。
taskforge:///new-task?name={query}&tags=inboxを開くRaycastスクリプトコマンドを作成し、Macのどこからでもタスクを追加できます。
Raycastの引数サポートを使って、検索バーから直接動的なタスク名を渡せます。
Alfred (macOS)
TaskForgeにタスクを送信するAlfredワークフローを構築しましょう。引数を受け取るカスタムキーワードを作成し、URLエンコードされたパラメータとしてTaskForgeのディープリンクに渡せます。
キーワード"task"でtaskforge:///new-task?name={query}&tags=alfredを開くワークフローを作成します。
Alfredの"Open URL"アクションと動的引数を使って素早くキャプチャできます。
Tasker (Android)
TaskerでAndroid上のTaskForgeを自動化しましょう。"Browse URL"アクションを使って、時間、場所、イベントをトリガーとしたTaskerプロファイルからTaskForgeのディープリンクを開けます。
オフィスのWi-Fiに接続した時にtaskforge:///space/Work%20Tasksを開くTaskerプロファイルを作成します。
AutoInputやその他のTaskerプラグインと組み合わせて、高度な自動化フローを実現できます。
Keyboard Maestro (macOS)
ディープリンクでTaskForgeのアクションをトリガーするマクロを作成しましょう。テキスト展開、クリップボード監視、キーボードショートカットと組み合わせて、コンテキストに応じたタスク作成が可能です。
taskforge:///new-task?name=%CurrentClipboard%&tags=captureを開くホットキーマクロを設定し、クリップボードからタスクを作成します。
あらゆるアプリで選択したテキストからタスクを作成するのに最適です。
IFTTT / Zapier / Make
TaskForgeを数百のWebサービスと接続しましょう。WebhookやURLアクションを使って、メール、カレンダーの予定、フォーム送信、これらのプラットフォームが対応するあらゆるトリガーからタスクを作成できます。
Gmailメッセージに特定のラベルが追加された時にTaskForgeのディープリンクを開くZapierワークフローを作成します。
これらのプラットフォームのURLエンコード機能を使って、動的データをディープリンクパラメータに安全に渡せます。
Webページとブックマークレット
任意のWebページにTaskForgeのディープリンクを追加したり、ブラウザのブックマークレットを作成して素早くタスクを作成できます。アプリがインストールされているデバイスでリンクをクリックするとTaskForgeが開きます。
HTML: <a href="taskforge:///new-task?name=Review%20Document">Add Review Task</a>
現在のページタイトルをタスク名としてキャプチャするブックマークレットを作成しましょう。
エラー処理
- 無効なパラメータは、エラーを出さずに無視されます。そのフィールドなしでタスクが作成され、ユーザーのデフォルト設定にフォールバックします。
- 不正な日付（例：dueDate=not-a-date）はスキップされ、フィールドは空のままになります。
- 無効な列挙値（例：priority=SuperHigh）はスキップされます。
- remindersパラメータの不正なJSONはスキップされます。
- 不明なルートはホーム画面にフォールバックします。
- 解決できないノートパス、または保管庫が設定されていない状態で開かれたノートリンクは、エラーにはならずノートブラウザを開きます。
- 必要なデータが不足している場合（例：タスクIDなしの/task/）はホーム画面にフォールバックします。
プラットフォーム対応
iOS & macOS
taskforge://URLスキームはアプリのInfo.plistに登録されています。ディープリンクはSafari、ショートカット、Spotlight、URLを開けるあらゆるアプリから動作します。
Android
taskforge://URLスキームはAndroidManifest.xmlのインテントフィルターを通じて登録されています。ディープリンクはACTION_VIEWインテントを発行できるあらゆるアプリから動作します。
よくある質問
ディープリンクはすべてのプラットフォームで動作しますか？
はい。TaskForgeのディープリンクはiOS、iPadOS、macOS、Android、Windowsで動作します。taskforge://URLスキームは各プラットフォームにネイティブで登録されています。
ディープリンクのパラメータをローカライズする必要はありますか？
いいえ。ディープリンクのパラメータはアプリの言語設定に関係なく常に英語です。ルートパス、パラメータ名、優先度などの列挙値は常に英語です。タスク名やタグなどの自由入力の値は、どの言語でも使えます。その場合はURLエンコードしてください。
無効なパラメータを使用した場合はどうなりますか？
無効なパラメータや認識できないパラメータは、エラーを出さずに無視されます。不足しているフィールドには設定済みのデフォルト値が使用され、タスクは引き続き作成されます。
ディープリンクでリマインダー付きのタスクを作成できますか？
はい。リマインダーはremindersパラメータを使ってURLエンコードされたJSON配列として渡します。各リマインダーオブジェクトにはtype、relatedTo、offsetなどのフィールドが含まれます。完全なJSONフォーマットについてはアプリ内のディープリンクリファレンスをご覧ください。
listIdパラメータ用のリストIDはどのように取得しますか？
TaskForgeでカスタムスペースエディタを開き、リンクアイコンをタップします。ディープリンクURLにlistIdパラメータで使用できるリスト識別子が含まれています。
Obsidianでディープリンクを使用できますか？
もちろんです。Obsidianのノートに[Create Task](taskforge:///new-task?name=My%20Task)のようなMarkdownリンクを直接追加してください。リンクをクリックするとTaskForgeが開き、タスクが作成されます。
関連機能
タスクワークフローの自動化を 始めましょう
TaskForgeをダウンロードして、ディープリンクであらゆるアプリからObsidianタスク管理を自動化しましょう。