skills.rest
AmirulAndalib
AmirulAndalibCOMMUNITY
Explore all skills by this author →
GitHub

things-mac

Manage Things 3 todos, projects, and tags on macOS via the things3-cli command line.

Updated Jun 19, 2026
Search Tags:#task management#productivity#cli#macos#todo#things 3#url scheme
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill things-mac-amirulandalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/things-mac
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill things-mac-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires things3-cli.

What problem does it solve? It lets you read and modify your local Things 3 database from the terminal or an AI assistant, so you can add, update, search, and inspect todos without opening the Things app manually. ## Core Features & Use Cases - Read your database: List inbox, today, upcoming, projects, areas, and tags, or search todos directly from the local Things database. - Add todos via URL scheme: Create tasks with notes, deadlines, tags, checklists, project/heading placement, or multi-line input from STDIN. - Update existing todos: Change titles, notes, tags, lists, or mark items completed/canceled using the Things auth token. - Use Case: Ask your assistant to add "Book flights" to your Travel project with a Friday deadline, then search for it later to confirm it was created. ## Quick Start Ask the assistant to add a todo called "Buy milk" with a note to your Things inbox using the things CLI.

Frequently Asked Questions about things-mac

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a todo to Things 3 from the command line?▼

Use the things3-cli add command, for example: things add "Buy milk" --notes "2%" --when today. It builds a Things URL scheme call, and you can preview it safely with --dry-run before opening Things.

How do I update or complete a Things 3 task from the terminal?▼

First find the task UUID with things search, then run things update --id <UUID> --auth-token <TOKEN> with flags like --completed, --notes, or --tags. Set THINGS_AUTH_TOKEN to avoid passing the token each time.

Why does things3-cli fail to read my Things database?▼

Database reads fail when the calling app lacks Full Disk Access on macOS. Grant it to Terminal for manual runs or to the host app for gateway runs, and optionally set THINGSDB to point at your ThingsData folder.

Can I delete a Things 3 todo using things3-cli?▼

No, deletion is not supported by things3-cli since there is no delete write command and things trash is read-only. Mark items as --completed or --canceled instead, or delete them in the Things UI.

Does things3-cli work on Windows or Linux?▼

No, it is macOS-only because it depends on the Things 3 Mac app, its local database, and the Things URL scheme. It is installed via go install on macOS, ideally into /opt/homebrew/bin on Apple Silicon.

Related Skills

Explore More Personal & Entrepreneur Skills→
trpc-grouptrpc-group
1.8k

things-mac

Manage Things 3 tasks on macOS via the things CLI and URL scheme.

Official
Basic
chenguojun06-starchenguojun06-star
1

lark-workflow-standup-report

Combine Lark calendar events and task lists into daily schedule summaries.

Community
Intermediate
readdlereaddle
136

spark-recipe-shared-inbox-triage

Process open shared inbox items by assigning ownership and marking resolutions done.

Official
Intermediate
pertain99pertain99
1

things-mac

Automate Things 3 task management on macOS via the things CLI.

Community
Intermediate