Things 3 CLI は何をしますか？
things を使用して、ローカルの Things データベース（受信箱/今日/検索/プロジェクト/エリア/タグ）を読み取り、Things URL スキームを介して ToDo を追加・更新します。
セットアップ
- インストール（推奨、Apple Silicon）：
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest - DB 読み取りに失敗する場合：呼び出し元のアプリにフルディスクアクセスを許可してください（手動実行の場合はターミナル、ゲートウェイ経由の場合は
OpenClaw.app）。 - オプション：
THINGSDBを設定（または--dbを指定）してThingsData-*フォルダを指定します。 - オプション：
THINGS_AUTH_TOKENを設定すると、更新操作で--auth-tokenを毎回渡す必要がなくなります。
読み取り操作（DB）
things inbox --limit 50things todaythings upcomingthings search "クエリ"things projects/things areas/things tags
書き込み操作（URL スキーム）
- 安全なプレビューを推奨：
things --dry-run add "タイトル" - 追加：
things add "タイトル" --notes "..." --when today --deadline 2026-01-02 - Things を前面に表示：
things --foreground add "タイトル"
使用例：ToDo の追加
- 基本：
things add "牛乳を買う" - メモ付き：
things add "牛乳を買う" --notes "2% + バナナ" - プロジェクト/エリアに追加：
things add "航空券を予約" --list "旅行" - プロジェクトの見出しに追加：
things add "充電器を詰める" --list "旅行" --heading "出発前" - タグ付き：
things add "歯医者に電話" --tags "健康,電話" - チェックリスト：
things add "旅行準備" --checklist-item "パスポート" --checklist-item "チケット" - STDIN から（複数行 → タイトル + メモ）：
cat <<'EOF' | things add -タイトル行メモ行1メモ行2EOF
使用例：ToDo の変更（認証トークンが必要）
- まず、ID（UUID 列）を取得：
things search "牛乳" --limit 5 - 認証：
THINGS_AUTH_TOKENを設定するか、--auth-token <TOKEN>を渡します。 - タイトル：
things update --id <UUID> --auth-token <TOKEN> "新しいタイトル" - メモの置き換え：
things update --id <UUID> --auth-token <TOKEN> --notes "新しいメモ" - メモの追加/先頭追加：
things update --id <UUID> --auth-token <TOKEN> --append-notes "..."/--prepend-notes "..." - リストの移動：
things update --id <UUID> --auth-token <TOKEN> --list "旅行" --heading "出発前" - タグの置き換え/追加：
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 の削除？
things3-cliでは現在サポートされていません（「削除/ゴミ箱へ移動」の書き込みコマンドはありません。things trashは読み取り専用の一覧表示です）。- 代替方法：Things の UI で削除/ゴミ箱へ移動するか、
things updateで--completed/--canceledとしてマークします。
注記
- macOS 専用です。
--dry-runは URL を表示し、Things は開きません。