things-mac

name	things-mac
description	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 Clawdbot to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
homepage	https://github.com/ossianhempel/things3-cli
metadata	{"clawdbot":{"emoji":"✅","os":["darwin"],"requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}

Things 3 CLI

Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.

Setup

• Install (recommended, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; Clawdbot.app for gateway runs).
• Optional: set THINGSDB (or pass --db) to point at your ThingsData-* folder.
• Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.

Read-only (DB)

• things inbox --limit 50
• things today
• things upcoming