ticktick

TickTick

{baseDir}/scripts/tt.sh を使ってタスクやプロジェクトを管理します。API の完全なリファレンスは references/api.md を参照してください。

認証： TICKTICK_TOKEN 環境変数に TickTick の個人用アクセストークン（tp_*）を設定します。Bearer トークンとして直接使用するため、OAuth フローは不要です。シークレットマネージャーまたはシェルプロファイルから読み込んでください。

タイムゾーン： 期限にはローカルの UTC オフセットが自動的に追加されます。TICKTICK_UTC_OFFSET（例：-03:00）で上書きし、必要に応じて TICKTICK_TIMEZONE（IANA 名、例：America/Buenos_Aires）も設定できます。

受信トレイ： ユーザーごとの受信トレイのプロジェクト ID は API から自動検出されます。追加の検索呼び出しを省略するには、TICKTICK_INBOX_ID を設定してください。

クイックリファレンス

TT="bash {baseDir}/scripts/tt.sh"

コマンド

プロジェクトの一覧表示

$TT projects

タスクの一覧表示

$TT tasks                          # inbox (default)
$TT tasks --project "Work"         # by name
$TT tasks --project <projectId>    # by ID

タスクの追加

$TT add "Buy tennis grip"
$TT add "Call accountant" --priority high --due "2026-02-20T10:00:00"
$TT add "Draft email" --project "Work" --priority med --notes "Reply to client"
$TT add "Review PR" --tag "work,code"

優先度の値：none | low | med | high

タスクの完了

$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)

タスクの更新

$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"

タスクの削除

$TT delete <taskId> --project <projectId>

プロジェクトの管理

$TT add-project "Tennis"           # creates new list
$TT add-project "Work" --color "#FF5733"
$TT delete-project <projectId>

ワークフロー

1. クイックキャプチャ — プロジェクトを指定しない場合、タスクは受信トレイに追加されます
2. taskId の確認 — $TT tasks または $TT tasks --project X を実行し、出力から ID をコピーします
3. projectId の確認 — $TT projects を実行し、ID をコピーします

表示形式

タスクをユーザーに表示する際は、次の形式にしてください。

📋 Inbox — 3 pending

  ○ [HIGH]  Call accountant            — due Feb 20
  ○ [MED]   Review analytics
  ○         Buy tennis racket grip

優先度（高い順）、次に期限の順で並べ替えます。依頼がない限り、完了済みのタスクは非表示にします。