things-mac

Automate Things 3 tasks on macOS via CLI and URL scheme.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Luzzer/Kraken --skill things-mac-luzzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/Luzzer/Kraken/tree/main/skills/things-mac
Command: npx skills add https://github.com/Luzzer/Kraken --skill things-mac-luzzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing tasks in Things 3 across devices can be slow when you switch to manual entry. This skill enables reading, listing, and updating local Things data and projects via the Things CLI and URL scheme on macOS to streamline task management from UAGENT.

Core Features & Use Cases

  • Read-only access to the Things database: inbox, today, upcoming, and tags, plus projects and areas.
  • Write operations: add or update todos using the Things URL scheme and the things CLI to automate task creation and organization.
  • Use Case: you want to quickly add a meeting task to Today with notes and place it under a project.

Quick Start

Add a new task to Things for today with the title Buy groceries.

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 to-dos from the command line on macOS?

You can manage Things 3 to-dos from the command line on macOS by interfacing with the things CLI and URL scheme to read, search, and update local task data, including inbox, today, upcoming, and tags.

Can I automate adding tasks to Things 3 projects using a CLI?

Yes, you can automate adding tasks to Things 3 projects using the things CLI and URL scheme to create and organize todos, including placing meeting tasks under specific projects with notes.

Do I need the things CLI installed to automate task management on macOS?

Yes, you need the things CLI installed and accessible on macOS to automate task management, as this approach relies on interfacing with the CLI and URL scheme to read and write local Things data.

What's the best way to list and inspect Things 3 areas and projects locally?

The best way to list and inspect Things 3 areas and projects locally is by using the things CLI on macOS, which provides read-only access to the database to view inbox, today, upcoming, tags, projects, and areas.

Does this task automation approach support updating existing todos in Things 3?

Yes, this task automation approach supports updating existing todos in Things 3 by utilizing the things URL scheme and CLI to write operations and automate task organization directly from your local macOS environment.

Why isn't my things CLI automation working for Things 3 on macOS?

Your things CLI automation for Things 3 on macOS may not work if the CLI is not installed or accessible in your environment, as reading, searching, and updating local data strictly depends on this CLI and the Things URL scheme.