things-mac

Things 3 CLI

Verwende things, um deine lokale Things-Datenbank (Inbox/Heute/Suche/Projekte/Bereiche/Tags) auszulesen und über das Things-URL-Schema Aufgaben hinzuzufügen und zu aktualisieren.

Einrichtung

• Installation (empfohlen, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• Falls DB-Lesevorgänge fehlschlagen: Gewähre Vollzugriff auf die Festplatte für die aufrufende App (Terminal für manuelle Ausführung; OpenClaw.app für Gateway-Ausführungen).
• Optional: Setze THINGSDB (oder übergib --db), um auf deinen ThingsData-*-Ordner zu verweisen.
• Optional: Setze THINGS_AUTH_TOKEN, um bei Aktualisierungsvorgängen die Übergabe von --auth-token zu vermeiden.

Nur Lesezugriff (DB)

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

Schreibzugriff (URL-Schema)

• Bevorzugte sichere Vorschau: things --dry-run add "Titel"
• Hinzufügen: things add "Titel" --notes "..." --when heute --deadline 2026-01-02
• Things in den Vordergrund holen: things --foreground add "Titel"

Beispiele: Aufgabe hinzufügen

• Einfach: things add "Milch kaufen"
• Mit Notizen: things add "Milch kaufen" --notes "2% + Bananen"
• In ein Projekt/einen Bereich: things add "Flüge buchen" --list "Reisen"
• In eine Projektüberschrift: things add "Ladegerät einpacken" --list "Reisen" --heading "Vorher"
• Mit Tags: things add "Zahnarzt anrufen" --tags "gesundheit,telefon"
• Checkliste: things add "Reisevorbereitung" --checklist-item "Reisepass" --checklist-item "Tickets"
• Von STDIN (mehrzeilig => Titel + Notizen):
  • cat <<'EOF' | things add -
  • Titelzeile
  • Notizzeile 1
  • Notizzeile 2
  • EOF

Beispiele: Aufgabe ändern (benötigt Authentifizierungstoken)

• Zuerst: ID (UUID-Spalte) abrufen: things search "milch" --limit 5
• Authentifizierung: Setze THINGS_AUTH_TOKEN oder übergib --auth-token <TOKEN>
• Titel: things update --id <UUID> --auth-token <TOKEN> "Neuer Titel"
• Notizen ersetzen: things update --id <UUID> --auth-token <TOKEN> --notes "Neue Notizen"
• Notizen anhängen/voranstellen: things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
• Listen wechseln: things update --id <UUID> --auth-token <TOKEN> --list "Reisen" --heading "Vorher"
• Tags ersetzen/hinzufügen: things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
• Abschließen/Abbrechen (weiches Löschen): things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
• Sichere Vorschau: things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

Aufgabe löschen?

• Wird von things3-cli derzeit nicht unterstützt (kein „Löschen/In den Papierkorb verschieben“-Schreibbefehl; things trash ist nur lesender Zugriff).
• Alternativen: Verwende die Things-Oberfläche zum Löschen/Entsorgen oder markiere sie über things update als --completed / --canceled.

Hinweise

• Nur für macOS.
• --dry-run gibt die URL aus und öffnet Things nicht.