things-mac

Read and manipulate local Things database tasks via the macOS CLI.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/karaabd23-crypto/openclaw --skill things-mac-karaabd23-crypto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/karaabd23-crypto/openclaw/tree/main/skills/things-mac
Command: npx skills add https://github.com/karaabd23-crypto/openclaw --skill things-mac-karaabd23-crypto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing Things 3 tasks via the macOS CLI and URL scheme lets you add, update, search, and list items without switching apps, saving time and reducing context switches.

Core Features & Use Cases

  • Read local Things data to list inbox, today, upcoming, projects, areas, and tags.
  • Add or update tasks via the Things URL scheme, including project associations and tags.
  • Quick operational flows for conversational prompts that require creating or querying tasks.

Quick Start

Add a new task called 'Prepare Q2 report' to Things under the 'Work' project.

Frequently Asked Questions about things-mac

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

FAQPage Schema
How do I manage Things 3 tasks from the macOS command line?

You can manage Things 3 tasks from the macOS command line by reading and manipulating the local Things database to list inbox, today, and upcoming items, or by adding and updating tasks via the Things URL scheme.

What do I need to read local Things database items on macOS?

To read local Things database items on macOS, you need the things CLI installed and may need to grant Full Disk Access to the terminal application so it can successfully query your local Things data.

Can I add a new task to a specific project in Things 3 via CLI?

Yes, you can add a new task to a specific project in Things 3 via CLI by using the Things URL scheme to create items, set project associations, and apply tags directly from your terminal commands.

Why does my things CLI fail to list inbox and upcoming items?

Your things CLI may fail to list inbox and upcoming items if the terminal lacks Full Disk Access, which is required to read the local Things database on macOS and retrieve your task data successfully.

Is automating task management through the macOS CLI better than using the Things app directly?

Automating task management through the macOS CLI is better than using the Things app directly when you want to add, update, search, or list items without switching apps, saving time and reducing context switches.