things-mac

• macOSでThings 3を使用していて、AIエージェントにタスクをインボックス、今日のリスト、または特定のプロジェクトに直接取り込んでほしい。
• Thingsデータベースをクエリしたい — 例：「今日の期限は何ですか？」や「healthタグのタスクを検索して」— アプリを開かずに。
• 既存のTodoを更新する必要がある：タイトルの変更、ノートの追記、別のプロジェクトへの移動、タグの追加、または完了/キャンセル済みのマーク。
• Thingsのデータに変更を加える前に、書き込み操作のドライランプレビューを確認したい。

• macOSを使用していない場合 — このスキルはDarwin専用であり、LinuxやWindowsでは動作しません。
• Todoを完全に削除またはゴミ箱に移動する必要がある場合；削除は基盤となるCLIツールではサポートされていません。
• Things 3がインストールされていない場合、このスキルはディスク上のアクティブなThings 3データベースに依存しています。

things-macのSQLiteデータベースから直接、インボックス、今日、近日中、およびログブックのビューをクエリします。Things 3を開いていなくても使用できます。--limitによるフィルタリングをサポートし、後続の操作に使用できるUUIDを含む構造化データを返します。

メモ、期日（--when、--deadline）、プロジェクト／エリアの割り当て（--list）、見出し、タグ、チェックリスト項目など、すべてを1つのコマンドから指定して新しいタスクを作成できます。複数行のタイトルとメモの入力には、STDINパイプも利用可能です。

UUIDを使用して任意のタスクを変更できます：名前の変更、メモの置き換えや追加・先頭への挿入、プロジェクト間の移動、タグの更新、または完了・キャンセルのマーク付け。書き込み操作にはthings-macの認証トークンが必要です。

--dry-run を渡すと、実際に Things を開いたり変更を確定したりすることなく、Things URL スキームのペイロードを出力します — エージェントが生成した操作を実行前に確認するのに便利です。

キーワードでタスクを検索するために、things-macデータベースに対して全文検索を実行し、後続の更新コマンドに必要なUUIDとメタデータを返します。

Things 3 のセットアップにあるすべてのプロジェクト、エリア、タグを一覧表示することで、エージェントが推測することなく新しいタスクを適切な宛先にインテリジェントに振り分けられるようにします。

エージェントとミーティングやアイデアについて話しながら、「これをthings-macのインボックスに追加して」と言うだけで、スキルが言及されたメモや期日とともにタスクをすぐに作成します — コピー＆ペーストは不要です。

エージェントに things-mac から今日のリストと近日中のリストを取得するよう依頼して、優先事項を確認したり、サマリーを取得したり、タスクの再スケジュールや注釈追加をエージェントに手伝ってもらいましょう。

キーワードでタスクを検索し、そのUUIDを取得したうえで、新しいメモを追記したり別のプロジェクトに移動したりします — タスクの存在は覚えているが、新しい情報を追加したい場合に役立ちます。

旅行やプロジェクトを計画する際に、1回の会話のやり取りで、特定のthings-macのプロジェクトと見出しに割り当てられた、チェックリスト付きのTodoを複数作成するようエージェントに依頼できます。