things-mac

Read and manage local Things 3 data via things3-cli on macOS.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/joeleung0122/testing --skill things-mac-joeleung0122
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/joeleung0122/testing/tree/main/skills/things-mac
Command: npx skills add https://github.com/joeleung0122/testing --skill things-mac-joeleung0122

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It enables you to read and modify your local Things 3 data from the macOS command line, allowing hands-free integration into automation and personal workflows.

Core Features & Use Cases

  • Read-only queries: inbox, today, upcoming, search, projects, areas, and tags from the Things database.
  • Write via URL scheme: add or update todos, assign to projects/areas, and attach notes, deadlines, and tags.
  • Use case: respond to requests to list tasks for today or add a new task to a project, all from the command line.

Quick Start

Install things3-cli on macOS and run a simple read or add command to manage your Things data.

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?

To manage Things 3 tasks from the macOS command line, this skill reads local database items and writes changes via the Things URL scheme. It automates querying inbox, today, and upcoming items directly from your terminal.

Can I add new todos to Things 3 projects using CLI automation?

Yes, you can add new todos to Things 3 projects using CLI automation. This skill writes via the Things URL scheme to create tasks, assign them to projects or areas, and attach notes, deadlines, and tags.

Do I need things3-cli installed to read local Things database on macOS?

Yes, you need the things3-cli binary installed to read the local Things database on macOS. This skill requires this dependency to execute read-only queries for inbox, today, upcoming, projects, areas, and tags.

What's the best way to automate macOS todo lists without opening the app?

The best way to automate macOS todo lists without opening the app is using this CLI skill with things3-cli. It queries the local Things database and writes updates via the URL scheme for hands-free personal workflow integration.

How does the Things URL scheme work for adding tags and deadlines?

The Things URL scheme works for adding tags and deadlines by constructing URLs that the skill sends to the app. This mechanism allows you to append notes, set deadlines, and assign tags when creating or updating tasks via the command line.

What are the limitations of using things3-cli for task automation?

Limitations of using things3-cli for task automation include its dependency on the local Things database and its restriction to macOS environments. Write operations rely entirely on the Things URL scheme rather than direct database modifications.