Todoist CLI スキル

このスキルは、td CLI ツールを使用して Todoist を操作するための手順ガイダンスを提供します。

前提条件

td CLI がインストールされ、認証されている必要があります。以下で確認してください：

td auth status

td がインストールされていない、または認証されていない場合：

• インストールされていない場合: ユーザーに npm install -g @doist/todoist-cli でインストールするよう伝えてください
• 認証されていない場合: ユーザーに td auth login を実行して OAuth で認証するよう伝えてください

エージェント向けの出力形式

マシンリーダブルな出力には、以下のフラグを使用してください：

• --json - JSON 配列として出力
• --ndjson - 改行区切り JSON として出力（1 行に 1 つのオブジェクト）
• --full - JSON 出力にすべてのフィールドを含める（デフォルトは必須フィールドのみ）

確認要件

破壊的なアクションを実行する前に、必ず AskUserQuestion または同様のツールを使用してユーザーの確認を求めてください。 単一の確認は、関連する論理的なアクションのグループに対して十分です。

破壊的なアクションには以下が含まれます：

• タスク、プロジェクト、セクション、ラベル、またはコメントの削除
• タスクの完了
• 既存リソースの更新
• プロジェクトのアーカイブ

読み取り専用操作は確認を必要としません。

クイックコマンド

コマンド	説明
td add "text"	自然言語解析によるクイック追加
td today	今日期限のタスクと期限切れのタスク
td upcoming [days]	次の N 日以内の期限のタスク（デフォルト: 7）
td inbox	Inbox 内のタスク
td completed	最近完了したタスク

クイック追加の例

td add "Buy milk tomorrow p1 #Shopping"
td add "Call dentist every monday @health"
td add "Review PR #Work /Code Review"

クイック追加パーサーは以下をサポートしています：

• 期限日: tomorrow, next monday, Jan 15
• 優先度: p1（緊急）～ p4（通常）
• プロジェクト: #ProjectName
• セクション: /SectionName
• ラベル: @label1 @label2

タスク

タスク一覧

td task list [options]

フィルター：

• --project <name> - プロジェクト名または id:xxx でフィルター
• --label <name> - ラベルでフィルター（複数の場合はカンマ区切り）
• --priority <p1-p4> - 優先度でフィルター
• --due <date> - 期限日でフィルター（today, overdue, または YYYY-MM-DD）
• --filter <query> - 生の Todoist フィルタークエリ
• --assignee <ref> - 担当者でフィルター（me または id:xxx）
• --workspace <name> - ワークスペースでフィルター
• --personal - 個人プロジェクトのみでフィルター

出力：

td task list --json                    # JSON 配列
td task list --project "Work" --json   # フィルター済み JSON
td task list --all --json              # すべてのタスク（制限なし）

タスクの詳細を表示

td task view <ref>              # 人間が読める形式
td task view <ref> --json       # JSON 出力

ref はタスク名、部分一致、または id:xxx です。

タスクを作成

クイック追加（自然言語）：

td add "Task text with #Project @label tomorrow p2"

明示的なフラグ：

td task add --content "Task text" \
  --project "Work" \
  --due "tomorrow" \
  --priority p2 \
  --labels "urgent,review" \
  --description "Additional details"

オプション：

• --content <text> - タスク内容（必須）
• --due <date> - 期限日（自然言語または YYYY-MM-DD）
• --deadline <date> - デッドライン日（YYYY-MM-DD）
• --priority <p1-p4> - 優先度レベル
• --project <name> - プロジェクト名または id:xxx
• --section <id> - セクション ID
• --labels <a,b> - カンマ区切りのラベル
• --parent <ref> - サブタスク用の親タスク
• --description <text> - タスクの説明
• --assignee <ref> - ユーザーに割り当て（名前、メール、id:xxx、または「me」）
• --duration <time> - 期間（例：30m, 1h, 2h15m）

タスクを更新

td task update <ref> --content "New content" --due "next week"

オプション：

• --content <text> - 新しい内容
• --due <date> - 新しい期限日
• --deadline <date> - デッドライン日
• --no-deadline - デッドラインを削除
• --priority <p1-p4> - 新しい優先度
• --labels <a,b> - ラベルを置き換え
• --description <text> - 新しい説明
• --assignee <ref> - ユーザーに割り当て
• --unassign - 担当者を削除
• --duration <time> - 期間

タスクを完了

td task complete <ref>

タスクを再開

td task uncomplete id:xxx

注：未完了化にはタスク ID（id:xxx 形式）が必要です。

タスクを削除

td task delete <ref>

タスクを移動

td task move <ref> --project "New Project"
td task move <ref> --section <section-id>
td task move <ref> --parent <task-ref>

ブラウザで開く

td task browse <ref>

プロジェクト

プロジェクト一覧

td project list                     # 人間が読める形式のツリー
td project list --json              # JSON 配列
td project list --personal --json   # 個人プロジェクトのみ

プロジェクトを表示

td project view <ref>
td project view <ref> --json

プロジェクトを作成

td project create --name "Project Name" \
  --color "blue" \
  --parent "Parent Project" \
  --view-style board \
  --favorite

オプション：

• --name <name> - プロジェクト名（必須）
• --color <color> - 色の名前
• --parent <ref> - ネスト用の親プロジェクト
• --view-style <style> - 「list」または「board」
• --favorite - お気に入りにマーク

プロジェクトを更新

td project update <ref> --name "New Name" --color "red"

プロジェクトをアーカイブ/アーカイブ解除

td project archive <ref>
td project unarchive <ref>

プロジェクトを削除

td project delete <ref>

注：プロジェクトに未完了のタスクがないことが必要です。

コラボレーターを一覧表示

td project collaborators <ref>

セクション

セクション一覧

td section list <project>           # 人間が読める形式
td section list <project> --json    # JSON 配列

セクションを作成

td section create --name "Section Name" --project "Project Name"

セクションを更新

td section update <id> --name "New Name"

セクションを削除

td section delete <id>

ラベル

ラベル一覧

td label list              # 人間が読める形式
td label list --json       # JSON 配列

ラベルを作成

td label create --name "label-name" --color "green" --favorite

ラベルを更新

td label update <ref> --name "new-name" --color "blue"

ラベルを削除

td label delete <name>

コメント

コメント一覧

td comment list <task-ref>                    # タスク上のコメント
td comment list <project-ref> --project       # プロジェクト上のコメント

コメントを追加

td comment add <task-ref> --content "Comment text"
td comment add <project-ref> --project --content "Comment text"

コメントを更新

td comment update <id> --content "Updated text"

コメントを削除

td comment delete <id>

リマインダー

リマインダー一覧

td reminder list <task-ref>

リマインダーを追加

td reminder add <task-ref> --due "tomorrow 9am"

リマインダーを削除

td reminder delete <id>

フィルター

保存済みフィルター一覧

td filter list --json

フィルターに一致するタスクを表示

td filter show <filter-ref> --json

フィルターを作成

td filter create --name "My Filter" --query "today & p1"

完了したタスク

td completed                              # 今日の完了したタスク
td completed --since 2024-01-01           # 特定の日付以降
td completed --project "Work" --json      # フィルター済み JSON 出力
td completed --all --json                 # すべての完了したタスク（制限なし）

オプション：

• --since <date> - 開始日（YYYY-MM-DD）、デフォルト：今日
• --until <date> - 終了日（YYYY-MM-DD）、デフォルト：明日
• --project <name> - プロジェクトでフィルター

アクティビティと統計

td activity                  # 最近のアクティビティ
td stats                     # 生産性統計と karma

ページネーション

大規模な結果セットの場合、--all を使用してすべて取得するか、カーソルでページネーションを処理します：

# 最初のページ
result=$(td task list --json --limit 50)

# レスポンスに next_cursor がある場合は続行
cursor=$(echo "$result" | jq -r '.[-1].id // empty')
td task list --json --limit 50 --cursor "$cursor"

参照解決

コマンドの <ref> パラメーターは以下を受け入れます：

• タスク/プロジェクト/ラベル名（部分一致をサポート）
• id:xxx による正確な ID マッチ
• 数値 ID（id:xxx として解釈）

追加リファレンス

特定のトピックの詳細については、以下を参照してください：

• references/completed-tasks.md - API 経由での完了したタスク履歴の代替方法
• references/filters.md - --filter フラグ用の Todoist フィルタークエリ構文

ワークフロー概要

1. 認証を確認 - td auth status
2. 読み取り操作 - 確認なしで直接実行
3. 書き込み操作 - 実行前にユーザーの確認を求める
4. JSON 出力を使用 - マシンリーダブルなデータに --json フラグを追加
5. 大規模なデータセットを処理 - --all を使用するか、--cursor でページネーションを処理