things-mac

Manage Things 3 tasks on macOS via the things CLI and local database.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of switching into Things 3 for routine task management, letting you create, update, search, and review your work from a conversational workflow on macOS.

Core Features & Use Cases

  • Add and update todos through the Things URL scheme with notes, dates, tags, lists, headings, checklist items, and completion status.
  • Read your local Things database to inspect inbox, today, upcoming, projects, areas, tags, and search results.
  • Use it when you want to capture a new task quickly, organize it into the right project, or audit what is already on your board without opening the app.

Quick Start

Ask the assistant to add a new Things task on your Mac, list your inbox items, or search your projects and tags.

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 CLI on macOS?

You can manage Things 3 tasks from the CLI on macOS by using a things binary and local database reader to add todos, update notes, and search projects without opening the app.

Do I need Full Disk Access to read the local Things database?

Yes, you need to grant Full Disk Access to read the local Things database directly, and you can optionally configure a custom THINGSDB path for database queries.

Can I add todos with tags and dates using the Things URL scheme?

Yes, you can add and update todos using the Things URL scheme with notes, dates, tags, lists, headings, checklist items, and completion status directly from desktop workflows.

What's the best way to search and inspect Things 3 inbox and upcoming lists?

The best way to search and inspect Things 3 inbox, today, upcoming, projects, areas, and tags is to read the local Things database through the things CLI on macOS.

Does the things CLI require an authentication token for task management?

Task management via the things CLI optionally supports a THINGS_AUTH_TOKEN configuration, which may be required depending on your specific things binary setup and local database access.