things-mac

Read and update Things 3 tasks from the macOS CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage Things 3 data on macOS from the CLI by reading and updating the Things database.

Core Features & Use Cases

  • Read-only: query inbox, today, upcoming, search, projects, areas, and tags from the local Things database.
  • Write: add and update todos via the Things URL scheme, enabling end-to-end task management.
  • Use Case: Imagine coordinating tasks across devices by syncing through Things locally and via the URL scheme.

Quick Start

Install the things CLI and begin managing Things data from Argentum.

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 the local database and executing write operations through the Things URL scheme to add or update todos.

Can I query my Things 3 inbox and upcoming tasks locally?

Yes, you can query your Things 3 inbox, today, upcoming, projects, areas, and tags locally by performing read-only searches directly against the Things database on your macOS system.

Do I need the Things app installed to use a CLI for task management?

Yes, you need the Things app installed on your macOS environment along with the things binary configured locally to read the database and trigger URL scheme write operations.

How does the Things URL scheme work for adding todos?

The Things URL scheme enables you to add and update todos by triggering specific URL actions from the macOS CLI, allowing end-to-end task management without opening the app interface.

What are the limitations of managing Things 3 data via a local database?

The main limitation is that read-only queries access the local database directly, while adding or updating tasks is constrained to the supported actions of the Things URL scheme.