my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	---
#2	name: things-mac
#3	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.
#4	homepage: https://github.com/ossianhempel/things3-cli
#5	metadata: {"clawdbot":{"emoji":"✅","os":["darwin"],"requires":{"bins":["things"]},"install":[{"id":"go","kind":"go","module":"github.com/ossianhempel/things3-cli/cmd/things@latest","bins":["things"],"label":"Install things3-cli (go)"}]}}
#6	---
#7
#8	# Things 3 CLI
#9
#10	Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
#11
#12	Setup
#13	- Install (recommended, Apple Silicon): `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest`
#14	- If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; `Clawdbot.app` for gateway runs).
#15	- Optional: set `THINGSDB` (or pass `--db`) to point at your `ThingsData-*` folder.
#16	- Optional: set `THINGS_AUTH_TOKEN` to avoid passing `--auth-token` for update ops.
#17
#18	Read-only (DB)
#19	- `things inbox --limit 50`
#20	- `things today`
#21	- `things upcoming`
#22	- `things search "query"`
#23	- `things projects` / `things areas` / `things tags`
#24
#25	Write (URL scheme)
#26	- Prefer safe preview: `things --dry-run add "Title"`
#27	- Add: `things add "Title" --notes "..." --when today --deadline 2026-01-02`
#28	- Bring Things to front: `things --foreground add "Title"`
#29
#30	Examples: add a todo
#31	- Basic: `things add "Buy milk"`
#32	- With notes: `things add "Buy milk" --notes "2% + bananas"`
#33	- Into a project/area: `things add "Book flights" --list "Travel"`
#34	- Into a project heading: `things add "Pack charger" --list "Travel" --heading "Before"`
#35	- With tags: `things add "Call dentist" --tags "health,phone"`
#36	- Checklist: `things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"`
#37	- From STDIN (multi-line => title + notes):
#38	- `cat <<'EOF' \| things add -`
#39	- `Title line`
#40	- `Notes line 1`
#41	- `Notes line 2`
#42	- `EOF`
#43
#44	Examples: modify a todo (needs auth token)
#45	- First: get the ID (UUID column): `things search "milk" --limit 5`
#46	- Auth: set `THINGS_AUTH_TOKEN` or pass `--auth-token <TOKEN>`
#47	- Title: `things update --id <UUID> --auth-token <TOKEN> "New title"`
#48	- Notes replace: `things update --id <UUID> --auth-token <TOKEN> --notes "New notes"`
#49	- Notes append/prepend: `things update --id <UUID> --auth-token <TOKEN> --append-notes "..."` / `--prepend-notes "..."`
#50	- Move lists: `things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"`
#51	- Tags replace/add: `things update --id <UUID> --auth-token <TOKEN> --tags "a,b"` / `things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"`
#52	- Complete/cancel (soft-delete-ish): `things update --id <UUID> --auth-token <TOKEN> --completed` / `--canceled`
#53	- Safe preview: `things --dry-run update --id <UUID> --auth-token <TOKEN> --completed`
#54
#55	Delete a todo?
#56	- Not supported by `things3-cli` right now (no “delete/move-to-trash” write command; `things trash` is read-only listing).
#57	- Options: use Things UI to delete/trash, or mark as `--completed` / `--canceled` via `things update`.
#58
#59	Notes
#60	- macOS-only.
#61	- `--dry-run` prints the URL and does not open Things.
#62

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public