steipete/things-todo

Things 3 CLI経由でタスクの追加、一覧表示、検索、更新、削除、確認を行います。

things-todo とは?

このスキルは、PeterのMac上でThings 3アプリケーションと連携し、CLIツール`things`を使ってタスク管理を効率化します。**主な機能**として、タスクの追加(日付、期限、タグ、プロジェクト指定可能)、検索・一覧表示(JSON形式対応)、更新・削除(UUIDベース)、そして動作確認(--dry-run)をサポートします。**利点**は、Things独自のデータベースではなく、Things URL SchemeとAppleScript経由で安全に書き込みを行い、読み取りはSQLiteの直接操作を避ける設計です。**対応プラットフォーム**はmacOSのみで、リモートホストではThings.appが利用できない場合があります。認証には`THINGS_AUTH_TOKEN`が必要で、`~/.profile`や1Passwordから取得し、ログに出力しないよう注意します。**使い方**は、まず`things tasks --format json`でタスクを確認し、`things add`で追加、`things update --id <uuid>`で更新、`things delete --id <uuid>`で削除します。変更後は必ず読み返して結果を確認します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/things-todo

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Things Todo

PeterのMac上のThings 3タスクに使用します。ThingsバックエンドのTODOにはthingsを優先し、ユーザーがApple Remindersを明示的に要求した場合のみ$remindersを使用します。

ツール

  • CLI: things
  • リポジトリ: https://github.com/ossianhempel/things3-cli
  • インストール:
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest

更新URL操作用の認証:

source ~/.profile >/dev/null 2>&1 || true
things auth

THINGS_AUTH_TOKENは~/.profileまたは1Passwordから取得します。決して表示しないでください。 things update --dry-runでは、これをauth-token=***としてマスクする必要があります。

開始

スクリプトによる読み取りと確認にはJSONを使用します:

things tasks --format json --limit 20
things today --format json
things search "query" --format json

Things DBの読み取りには、呼び出し元アプリにフルディスクアクセスが必要な場合があります。書き込みはthingsを介してThings URL SchemeまたはAppleScriptを通じて行います。SQLite DBを直接書き込まないでください。

追加

デフォルト: 追加後、検索/読み返します。

things add "LHR-SFO間の直行便ビジネスクラスを予約" --notes "直行便のみ" --when tomorrow --tags travel
things tasks --search "LHR-SFO" --format json

便利なフラグ:

  • --notes "テキスト"
  • --when today|tomorrow|evening|anytime|someday|YYYY-MM-DD
  • --deadline YYYY-MM-DD
  • --list "プロジェクトまたはエリア"
  • --tags タグ1,タグ2
  • --checklist-item "テキスト" 繰り返し可能
  • --dry-run 変更せずにthings:/// URLを検査します。

更新 / 削除

まずUUIDを検索し、IDで変更します:

things tasks --search "flight" --format json
things update --id <uuid> "新しいタイトル" --notes "更新されたメモ"
things tasks --search "新しいタイトル" --format json
things delete --id <uuid> --confirm <uuid>
things tasks --search "新しいタイトル" --format json
things trash --search "新しいタイトル" --format json

書き込み後は必ず読み返します。削除はアイテムをThingsのゴミ箱に移動します。クリーンアップの際には、通常の検索が空で、ゴミ箱検索にアイテムが含まれていることを確認します。

慣例

  • 曖昧な要求は具体的な次のアクションのタイトルに変換します。
  • ユーザーが明らかに記録を希望している場合、表現をそのまま保持します。
  • 無関係なアクションは別々のTODOに分割します。
  • 「今日」はユーザーが暗に示した場合のみ使用します。それ以外は受信箱/いつでもをデフォルトとします。
  • 一括更新/削除の前には--dry-runを推奨します。
  • 現在の日付計算にはdateコマンドを実行します。推測はしないでください。

注意点

  • macOSのみです。リモートホストでは、Things.appが存在しないか表示されない場合、バージョンがUNKNOWNと表示されることがあります。
  • updateはTHINGS_AUTH_TOKENを必要とします。addは必要ありません。
  • --tagsは追加/更新では複数形です。tasks --tagはフィルタリングでは単数形です。
  • todayのJSONではstart: Anytimeと実際のstart_dateが表示される場合があります。今日の配置を確認するには、単一のフィールドではなく、コマンドのメンバーシップ/読み返しを使用します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル