things-mac

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

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill things-mac-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/things-mac
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill things-mac-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Things 3 tasks from the terminal or an AI assistant normally requires opening the app manually; this Skill lets you read your local Things database and create or update todos directly through the things3-cli tool. ## Core Features & Use Cases - Read your database: List inbox, today, upcoming, search results, projects, areas, and tags straight from the local Things database. - Create todos: Add tasks with notes, deadlines, tags, checklists, project/area assignment, and headings via the Things URL scheme, with a --dry-run preview mode. - Update existing todos: Modify titles, notes, tags, lists, and mark items completed or canceled using the Things auth token. - Use Case: Ask your assistant to add "Book flights" to your Travel project with a Friday deadline, then list everything due today without opening the Things app. ## Quick Start Ask the assistant to add a todo like "Buy milk" to Things 3 and then show what is on your today list.

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 command `things add "Title"` with optional flags like --notes, --when, --deadline, --tags, and --list to set the project or area. Preview the action first with `things --dry-run add "Title"` to see the URL without opening Things.

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

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

Why do Things database reads fail with things3-cli?

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

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

No, things3-cli does not support deleting or moving todos to trash; the `things trash` command is read-only. Instead, mark items with --completed or --canceled via `things update`, or delete them manually in the Things app.

Does things3-cli work on Windows or Linux?

No, this Skill is macOS-only because Things 3 is an Apple-platform app and the tool reads the local macOS Things database and uses the Things URL scheme. It requires the things binary installed via Go on macOS.