things-mac

Things 3 CLI

things を使用して、ローカルの Things データベース（インボックス／今日／検索／プロジェクト／エリア／タグ）を読み取り、Things URL スキーム経由で ToDo を追加・更新できます。

セットアップ

• インストール済みか確認します：which things（パスが返された場合は、インストールをスキップします）
• インストール（Homebrew）：brew install ossianhempel/tap/things3-cli
• インストール（Go、Apple Silicon 向けに推奨）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• 必要に応じて、THINGSDB を設定するか（または --db を渡して）、ThingsData-* フォルダーを指定します。

Things 認証トークン

更新操作には認証トークンが必要です。永続化するには、シェルのプロファイル（例：~/.zshrc）で THINGS_AUTH_TOKEN を設定してください。

読み取り専用（DB）

• things inbox --limit 50
• things today / things logtoday / things createdtoday
• things upcoming / things deadlines
• things search "query"
• things projects / things areas / things tags
• 内容を確認：
  • things show "Area Name" / things show "Project Name"
  • things tasks --area "Area Name"
  • things tasks --project "Project Name"

書き込み（URL スキーム）

• 安全なプレビューを優先します：things --dry-run add "Title"
• 追加：things add "Title" --notes "..." --when today --deadline 2026-01-02
• スケジュール設定：--when=someday、--later（今晩）、--when=evening
• Things を前面に表示：things --foreground add "Title"

例

ToDo を追加する

• 基本：things add "Buy milk"
• メモ付き：things add "Buy milk" --notes "2% + bananas"
• プロジェクト／エリアに追加：things add "Book flights" --list "Travel"
• プロジェクトの見出しに追加：things add "Pack charger" --list "Travel" --heading "Before"
• タグ付き：things add "Call dentist" --tags "health,phone"
• チェックリスト：things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
• 繰り返し：things add "Daily standup" --repeat day --repeat-mode schedule
• 標準入力から（複数行の場合、タイトルとメモになります）：
  • cat <<'EOF' | things add -
  • Title line
  • Notes line 1
  • Notes line 2
  • EOF

プロジェクトとエリア

• エリアを追加：things add-area "Health"
• プロジェクトを追加：things add-project "New Site" --area "Work" --notes "Plan out the redesign"
• プロジェクトを更新：things update-project --id <UUID> --auth-token <TOKEN> "New Title" --notes "Updated notes"

ToDo を変更する（認証トークンが必要）

• まず ID（UUID 列）を取得します：things search "milk" --limit 5
• 認証：THINGS_AUTH_TOKEN を設定するか、--auth-token <TOKEN> を渡します
• タイトル：things update --id <UUID> --auth-token <TOKEN> "New title"
• メモを置き換え：things update --id <UUID> --auth-token <TOKEN> --notes "New notes"
• メモを末尾／先頭に追加：things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
• リストを移動：things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"
• タグを置き換え／追加：things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
• 完了／キャンセル（論理削除に相当）：things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
• 安全なプレビュー：things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

ToDo を削除する

• AppleScript 経由で削除できます：things delete --id <UUID>
• 次も使用できます：delete-project --id <UUID> および delete-area --id <UUID>
• 注：対話形式で確認を求められます。非対話型のスクリプトでは --confirm を使用してください。
• または、things update --id <UUID> --completed / --canceled で完了／キャンセル済みにします（認証トークンが必要です）。

注記

• macOS のみ対応です。
• --dry-run は URL を表示し、Things を開きません。