things-mac

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

1|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill things-mac-solizardking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/Solizardking/Solana-Robotics-Kit/tree/main/eliza/packages/skills/skills/things-mac
Command: npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill things-mac-solizardking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you read, search, add, and update Things 3 tasks from the command line on macOS without opening the app manually, bridging your local Things database with automated workflows. ## Core Features & Use Cases - Read the local database: List inbox, today, and upcoming tasks, search tasks, and inspect projects, areas, and tags directly from the Things database. - Add and update todos via URL scheme: Create tasks with notes, deadlines, tags, checklists, and project/heading placement, then update titles, notes, tags, or completion status using an auth token. - Safe previews: Use --dry-run to print the generated URL without opening Things. - Use Case: Ask your assistant to add "Book flights" to your Travel project with a Friday deadline, then later search for it by keyword and mark it completed. ## Quick Start Ask Otto to add a task to Things, for example: add "Buy milk" to my Things inbox with a note to get 2% and bananas.

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 task to Things 3 from the command line?

Use the things 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 search and list Things tasks from the terminal?

Run things search "query" to find tasks, or use things inbox, things today, and things upcoming to list items. You can also inspect projects, areas, and tags with the corresponding subcommands.

Does the things CLI work on Windows or Linux?

No, this skill is macOS-only because Things 3 and its local database exist only on Apple platforms. The skill metadata explicitly restricts it to darwin systems.

Why do Things database reads fail with permission errors?

Reads fail when the calling app lacks Full Disk Access on macOS. Grant Full Disk Access to Terminal for manual runs or to Otto.app for gateway runs, or point THINGSDB at your ThingsData folder.

Can I delete a Things task using the things CLI?

No, things3-cli does not support deleting or moving tasks to trash; things trash is read-only. Instead mark tasks with --completed or --canceled via things update, or delete them in the Things UI.