steipete/things-todo

Things 3 über die things CLI: Aufgaben hinzufügen, auflisten, suchen, aktualisieren, löschen und überprüfen.

Was ist things-todo?

Dieses Skill ermöglicht die Interaktion mit Things 3 (der macOS/iOS-Produktivitäts-App) über die CLI `things`. Es bietet Entwicklern und Power-Usern eine textbasierte Schnittstelle, um Aufgaben zu verwalten, ohne die Benutzeroberfläche von Things verwenden zu müssen. Das Skill führt CRUD-Operationen aus (Create, Read, Update, Delete): Aufgaben können hinzugefügt, mit Metadaten wie Notizen, Fälligkeitsdaten, Tags und Projekten versehen, gesucht und gelöscht werden. Die bevorzugte Ausgabe ist JSON für programmatische Weiterverarbeitung. Es unterstützt macOS vollständig und erfordert für einige Operationen einen Authentifizierungstoken (`THINGS_AUTH_TOKEN`) und ggf. vollen Festplattenzugriff. Das Skill folgt klaren Konventionen: vage Anfragen werden in konkrete nächste Aktionen umgewandelt, nicht zusammenhängende Aufgaben werden getrennt, und vor Massenänderungen wird ein Trockenlauf (`--dry-run`) empfohlen. Es bietet auch intelligente Standardwerte (z. B. Heute nur verwenden, wenn der Benutzer dies impliziert) und prüft nach jeder Schreiboperation durch erneutes Lesen.

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

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Things Todo

Verwende dies für Things 3 Aufgaben auf Peters Macs. Bevorzuge things für Things-gestützte Todos; verwende $reminders nur, wenn der Benutzer nach Apple Erinnerungen fragt.

Tool

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

Authentifizierung für Update-URL-Operationen:

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

THINGS_AUTH_TOKEN sollte aus ~/.profile oder 1Password kommen. Niemals ausgeben. things update --dry-run muss es als auth-token=*** schwärzen.

Start

Verwende JSON für Skript-gestützte Lese- und Überprüfungsvorgänge:

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

Things DB-Lesevorgänge benötigen möglicherweise "Voller Festplattenzugriff" für die aufrufende App. Schreibvorgänge sollten über das Things-URL-Schema oder AppleScript via things erfolgen; schreibe nicht direkt in die SQLite-Datenbank.

Hinzufügen

Standard: hinzufügen, dann zurücklesen/suchen.

things add "Buch LHR-SFO Nonstop-Geschäftsflug" --notes "Nur Nonstop." --when morgen --tags Reise
things tasks --search "LHR-SFO" --format json

Nützliche Flags:

  • --notes "Text"
  • --when heute|morgen|abends|beliebig|irgendwann|JJJJ-MM-TT
  • --deadline JJJJ-MM-TT
  • --list "Projekt oder Bereich"
  • --tags tag1,tag2
  • --checklist-item "Text" wiederholbar
  • --dry-run um die things:///-URL zu inspizieren, ohne zu ändern.

Aktualisieren / Löschen

Finde zuerst die UUID, dann ändere per ID:

things tasks --search "Flug" --format json
things update --id <uuid> "Neuer Titel" --notes "Aktualisierte Notizen"
things tasks --search "Neuer Titel" --format json
things delete --id <uuid> --confirm <uuid>
things tasks --search "Neuer Titel" --format json
things trash --search "Neuer Titel" --format json

Immer nach Schreibvorgängen zurücklesen. Löschen verschiebt Elemente in den Things-Papierkorb; überprüfe bei Bedarf, ob die normale Suche leer ist und die Papierkorb-Suche das Element enthält.

Konventionen

  • Vage Anfragen in konkrete nächste Aktions-Titel umwandeln.
  • Formulierung beibehalten, wenn der Benutzer eindeutig erfassen will, nicht umschreiben.
  • Nicht zusammenhängende Aktionen in separate Todos aufteilen.
  • "Heute" nur verwenden, wenn der Benutzer es impliziert; ansonsten Standardeinstellungen Posteingang/Beliebig verwenden.
  • Vor Massenaktualisierungen/-löschungen --dry-run bevorzugen.
  • Für Datumsberechnungen date ausführen; nicht raten.

Fallstricke

  • Nur macOS; entfernte Hosts zeigen möglicherweise die Things.app-Version als UNKNOWN an, wenn die App nicht vorhanden oder nicht sichtbar ist.
  • update benötigt THINGS_AUTH_TOKEN; add nicht.
  • --tags ist Plural bei Hinzufügen/Aktualisieren; tasks --tag ist Singular zum Filtern.
  • today JSON kann start: Beliebig plus ein echtes start_date anzeigen; verwende Befehlszugehörigkeit/Rücklesen, nicht nur ein Einzelfeld, um die Platzierung auf Heute zu überprüfen.

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.

Verwandte Skills