skills.rest
shalevamin
shalevaminCOMMUNITY
Explore all skills by this author →
GitHub

things-mac

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

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

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 AI agents and your local Things database. ## Core Features & Use Cases - Read-only database access: List inbox, today, upcoming, projects, areas, and tags, or search tasks directly from the local Things database. - Task creation via URL scheme: Add todos with notes, deadlines, tags, checklists, project/heading placement, and multi-line STDIN input, with a --dry-run safe preview. - Task updates with auth token: Modify titles, notes, tags, lists, and mark tasks completed or canceled using the Things auth token. - Use Case: Ask your agent to add "Book flights" to your Travel project with a deadline, then later search for it and mark it completed — all without touching the Things UI. ## Quick Start Ask the agent to add a task like "Buy milk" to Things 3 with a note and today's deadline 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 task to Things 3 from the command line?▼

Use the things CLI with the add command, for example `things add "Buy milk" --notes "2%" --when today`. You can target projects with `--list`, headings with `--heading`, and preview safely with `--dry-run` before opening Things.

How do I list or search Things 3 tasks from the terminal?▼

Run read-only commands like `things inbox`, `things today`, `things upcoming`, or `things search "query"` to query the local Things database. You can also list projects, areas, and tags with their respective subcommands.

Does the things CLI work on Windows or Linux?▼

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

Why do Things database reads fail with the things CLI?▼

Database reads fail when the calling app lacks Full Disk Access in macOS privacy settings. Grant Full Disk Access to Terminal for manual runs or to the host app for agent runs, or point `--db`/`THINGSDB` at your ThingsData folder.

Can I delete a Things 3 task using the things CLI?▼

No, deletion is not supported by things3-cli; the trash command is read-only listing only. Instead, mark tasks as completed or canceled with `things update --id <UUID> --auth-token <TOKEN> --completed` or `--canceled`.

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
niraclerniracler
11

schedule-manager

Orchestrate macOS Calendar and Reminders with GTD-driven workflows via osascript and reminders-cli.

Community
Intermediate
chlmmchlmm

flomo-reminder

Schedule reminders and push notifications for Flomo notes.

Community
Basic
builtby-winbuiltby-win

things-cli

Manage Things 3 tasks via command-line interface and URL schemes.

Official
Intermediate