things-mac

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

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill things-mac-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/things-mac
Command: npx skills add https://github.com/kcns008/clusterclaw --skill things-mac-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of managing Things 3 manually by letting you create, update, search, and inspect tasks from a macOS CLI workflow.

Core Features & Use Cases

  • Read your workspace: view inbox, today, upcoming, projects, areas, and tags from the local Things database.
  • Create and update tasks: add todos, set notes, deadlines, lists, headings, tags, checklists, and completion state through the Things URL scheme.
  • Safe operations: preview changes with dry-run support and use authentication only when modifying existing items.
  • Use case: A user asks to capture a new meeting follow-up, then later searches for it, moves it into a project, and marks it complete without opening the app manually.

Quick Start

Ask the skill to add a todo, search tasks, or list your inbox in Things on macOS.

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 using a things binary to read your inbox, add todos, update notes, and set deadlines through the Things URL scheme and local database.

Can I create and update todos in Things 3 without opening the app?

Yes, you can create and update todos without opening the app by sending commands via the Things URL scheme, allowing you to add tasks, set tags, and mark items complete directly from the CLI.

Do I need authentication to search and retrieve Things 3 tasks on macOS?

Authentication is optional for searching and retrieving Things 3 tasks on macOS; reading your workspace data from the local database requires no authentication, but modifying existing items requires it.

What is the best way to preview task changes before updating Things 3?

The best way to preview task changes before updating Things 3 is to use dry-run support, which allows you to safely inspect modifications before committing write operations to your todos and projects.

Does the Things 3 CLI workflow support viewing upcoming tasks and project areas?

Yes, the Things 3 CLI workflow supports viewing upcoming tasks and project areas by reading the local Things database, enabling you to inspect inbox items, today lists, areas, and tags directly.

Why are my Things 3 todo updates not working from the macOS CLI?

Your Things 3 todo updates may not be working from the macOS CLI if you lack the macOS-only things binary, do not have local database access, or are missing the required authentication for modifying existing items.