thingslisted
Install: claude install-skill yourkenike/ciana-parrot
# Things 3
Use the `things` bridge to manage Things 3 via the `things` CLI on the host.
## When to Use
- User asks to add a task or todo to Things
- Listing inbox, today, upcoming tasks
- Searching tasks or projects
- Managing Things areas and tags
## When NOT to Use
- Apple Reminders -> use apple-reminders bridge
- Notion/Trello tasks -> use those skills instead
- Ciana scheduled tasks -> use schedule_task tool
## Commands
All commands run via `host_execute(bridge="things", command="...")`.
### Read (from DB)
```
things inbox --limit 50
things today
things upcoming
things search "query"
things projects
things areas
things tags
```
### Add Todos
```
things add "Buy milk"
things add "Call mom" --notes "about dinner" --when today
things add "Meeting prep" --deadline 2026-02-15
things add "Book flights" --list "Travel"
things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
```
### Update Todos (needs auth token)
```
things search "milk" --limit 5 # Get UUID
things update --id <UUID> "New title"
things update --id <UUID> --completed
things update --id <UUID> --notes "New notes"
```
## Setup (on host)
- Install: `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest`
- Grant Full Disk Access to Terminal/gateway process
- Optional: set `THINGS_AUTH_TOKEN` env var for update operations
- Uncomment `things` bridge in `config.yaml`, restart gateway