steipete/things-todo

Intégration Things 3 via l'interface en ligne de commande `things` : ajouter, lister, rechercher, mettre à jour, supprimer et vérifier des tâches.

Qu'est-ce que things-todo ?

Cette compétence permet d'interagir avec Things 3, l'application de gestion de tâches macOS, via un CLI dédié (`things`). Elle est destinée aux utilisateurs de Claude Code, Cursor ou Codex qui souhaitent manipuler leurs tâches Things par programmation. Le CLI s'appuie sur le dépôt `ossianhempel/things3-cli` et nécessite une installation via `go install`. L'authentification pour les opérations de mise à jour utilise un jeton d'autorisation stocké dans `~/.profile` ou 1Password. Les entrées/sorties au format JSON sont privilégiées pour les scripts. La compétence couvre l'ajout, la recherche, la mise à jour, la suppression et la mise à la corbeille des tâches, avec des conventions pour transformer des demandes vagues en actions concrètes. Les lectures de la base de données nécessitent l'autorisation « Accès disque complet » pour l'application appelante ; les écritures passent par le schéma d'URL Things ou AppleScript, jamais directement en SQLite. L'outil est limité à macOS et peut signaler une version inconnue de Things.app sur les hôtes distants sans l'application.

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

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Things Todo

Utilisez cette compétence pour les tâches Things 3 sur les Macs de Peter. Privilégiez things pour les tâches Things ; utilisez $reminders uniquement lorsque l'utilisateur demande Apple Reminders.

Outil

  • CLI : things
  • Dépôt : https://github.com/ossianhempel/things3-cli
  • Installation :
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest

Authentification pour les opérations de mise à jour via URL :

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

THINGS_AUTH_TOKEN doit provenir de ~/.profile ou 1Password. Ne jamais l'afficher. things update --dry-run doit le masquer sous la forme auth-token=***.

Démarrage

Utilisez JSON pour les lectures scriptées et la vérification :

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

Les lectures de la base de données Things peuvent nécessiter l'autorisation « Accès disque complet » pour l'application appelante. Les écritures doivent passer par le schéma d'URL Things ou AppleScript via things ; n'écrivez pas directement dans la base SQLite.

Ajout

Par défaut : ajouter, puis rechercher/lire en retour.

things add "Réserver vol LHR-SFO en classe affaires sans escale" --notes "Sans escale uniquement." --when demain --tags voyage
things tasks --search "LHR-SFO" --format json

Indicateurs utiles :

  • --notes "texte"
  • --when aujourd'hui|demain|soir|n'importe quand|un jour|AAAA-MM-JJ
  • --deadline AAAA-MM-JJ
  • --list "Projet ou Zone"
  • --tags tag1,tag2
  • --checklist-item "texte" (répétable)
  • --dry-run pour inspecter l'URL things:/// sans effectuer de modification.

Mise à jour / Suppression

Trouvez d'abord l'UUID, puis effectuez la mutation par ID :

things tasks --search "vol" --format json
things update --id <uuid> "Nouveau titre" --notes "Notes mises à jour"
things tasks --search "Nouveau titre" --format json
things delete --id <uuid> --confirm <uuid>
things tasks --search "Nouveau titre" --format json
things trash --search "Nouveau titre" --format json

Toujours relire après les écritures. La suppression déplace les éléments dans la Corbeille Things ; vérifiez que la recherche normale est vide et que la recherche dans la corbeille contient l'élément lorsque le nettoyage est important.

Conventions

  • Transformez les demandes vagues en titres d'actions concrètes.
  • Préservez la formulation lorsque l'utilisateur souhaite clairement capturer, pas réécrire.
  • Séparez les actions non liées en tâches distinctes.
  • Utilisez « Aujourd'hui » uniquement si l'utilisateur l'implique ; sinon, utilisez les valeurs par défaut « Boîte de réception »/« N'importe quand ».
  • Privilégiez --dry-run avant les mises à jour/suppressions en masse.
  • Pour les calculs de date courante, exécutez date ; ne devinez pas.

Problèmes connus

  • macOS uniquement ; les hôtes distants peuvent afficher la version de Things.app comme UNKNOWN si l'application est absente ou non visible.
  • update nécessite THINGS_AUTH_TOKEN ; add non.
  • --tags est au pluriel pour ajouter/mettre à jour ; tasks --tag est au singulier pour le filtrage.
  • Le JSON de today peut afficher start: Anytime ainsi qu'une start_date réelle ; utilisez l'appartenance à la commande et la relecture, pas un seul champ, pour vérifier le placement dans « Aujourd'hui ».

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.

Skills associés