mcpField
T
things-mac

things-mac

github.com/openclaw生産性393.3k5.2k 回インストール今日更新
リポジトリ

things-mac について

things-mac は、コマンドラインから Things 3 を操作する macOS 向けスキルです。ローカルのタスクデータベースを読み取り、Things URL scheme で ToDo を追加・更新します。

主な機能

  1. 01受信箱と予定の読み取り
  2. 02ToDo とプロジェクトの検索
  3. 03ToDo とチェックリストの追加
  4. 04タグとステータスの更新
  5. 05書き込み操作のプレビュー

活用シーン

  1. 01今日または今後のタスクを確認
  2. 02プロジェクトにタグ付き ToDo を追加
  3. 03タスクの内容や完了状態を変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclaw/openclaw --skill things-mac

インストール後、Claude Code で/things-macを入力して読み込まれたか確認します。

詳細

Things 3 CLI

things を使用して、ローカルの Things データベース（受信箱／今日／検索／プロジェクト／エリア／タグ）を読み取り、Things URL スキーム経由で To-Do を追加／更新します。

セットアップ

  • インストール（推奨、Apple Silicon）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
  • DB の読み取りに失敗する場合：呼び出し元のアプリにフルディスクアクセスを許可します（手動実行では Terminal、ゲートウェイ実行では OpenClaw.app）。
  • 任意：THINGSDB を設定するか（または --db を渡して）、ThingsData-* フォルダーを指定します。
  • 任意：更新操作で --auth-token を渡さずに済むよう、THINGS_AUTH_TOKEN を設定します。

読み取り専用（DB）

  • things inbox --limit 50
  • things today
  • things upcoming
  • things search "query"
  • things projects / things areas / things tags

書き込み（URL スキーム）

  • 安全にプレビューするにはこちらを推奨：things --dry-run add "Title"
  • 追加：things add "Title" --notes "..." --when today --deadline 2026-01-02
  • Things を前面に表示：things --foreground add "Title"

例：To-Do を追加する

  • 基本：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"
  • STDIN から入力（複数行の場合、タイトル＋メモになります）：
    • cat <<'EOF' | things add -
    • Title line
    • Notes line 1
    • Notes line 2
    • EOF

例：To-Do を変更する（認証トークンが必要）

  • まず 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

To-Do を削除するには？

  • 現時点で things3-cli では対応していません（「削除／ゴミ箱に移動」する書き込みコマンドはありません。things trash は読み取り専用の一覧表示です）。
  • 方法：Things の UI から削除／ゴミ箱に移動するか、things update で --completed / --canceled を指定します。

メモ

  • macOS 専用です。
  • --dry-run は URL を表示し、Things を開きません。

コメント

Markdown 対応