things-mac

Manage Things 3 via the things CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

1. Zainstaluj things3-cli za pomocą Go. Na Apple Silicon uruchom: GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest. Dla innych architektur pomiń GOBIN i zainstaluj w domyślnej lokalizacji.

2. Przyznaj uprawnienia dostępu do dysku. Otwórz Ustawienia systemowe > Prywatność i bezpieczeństwo > Pełny dostęp do dysku. Dodaj aplikację Terminal (jeśli testujesz ręcznie) lub OpenClaw.app (jeśli korzystasz z agenta). Bez tego kroku odczyt bazy danych Things się nie powiedzie.

3. Opcjonalnie skonfiguruj zmienne środowiskowe. Ustaw THINGSDB, aby wskazać na folder ThingsData-*, jeśli Things przechowuje bazę w niestandardowej lokalizacji. Dla operacji zapisu ustaw THINGS_AUTH_TOKEN, aby uniknąć przekazywania tokenu przy każdym poleceniu.

4. Testuj odczyt danych. Uruchom things inbox --limit 50, aby wyświetlić ostatnie zadania. Spróbuj things today, things upcoming lub things search "fraza", aby zweryfikować dostęp do bazy danych.

5. Dodawaj zadania za pośrednictwem agenta. Poproś agenta, aby dodał zadanie do Things. Agent użyje polecenia things add "Tytuł" z opcjonalnymi flagami: --notes dla notatek, --when today dla harmonogramu, --deadline YYYY-MM-DD dla terminu, --list "Projekt" dla przypisania do projektu.

6. Użyj --dry-run do podglądu. Przed faktycznym dodaniem zadania agent może uruchomić things --dry-run add "Tytuł", aby pokazać Ci dokładnie, co zostanie utworzone, bez zmian w Things.