things-mac

Automate Things 3 task management on macOS via the things CLI and URL scheme.

2|1|Updated Oct 8, 2009
One-click install
npx skills add https://github.com/riethmayer/dotfiles --skill things-mac-riethmayer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/riethmayer/dotfiles/tree/main/stow/agents/.agents/skills/things-mac
Command: npx skills add https://github.com/riethmayer/dotfiles --skill things-mac-riethmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage Things 3 tasks on macOS via the things CLI and URL scheme to add, update, or read tasks and projects from the local Things database.

Core Features & Use Cases

  • Read-only: list inbox, today, upcoming, projects, areas, and tags from the local Things database.
  • Write: add, update, and complete tasks or move items via the Things URL scheme.
  • Use Case: When you want to automate task creation from a script and reflect changes in Things without opening the app.

Quick Start

Install things3-cli on macOS and grant access to the Things database, then run a sample operation like things inbox to verify setup.

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 command line on macOS?

You can manage Things 3 tasks from the command line on macOS by using the things CLI and URL scheme to add, update, list, and inspect tasks and projects within the local Things database.

Can I automate adding tasks to Things 3 without opening the app?

Yes, you can automate adding tasks to Things 3 without opening the app by executing write operations through the Things URL scheme via the things CLI binary on your macOS system.

What do I need to read tasks from the local Things database?

To read tasks from the local Things database, you need macOS, the things CLI binary installed, and explicit access granted to the Things database to perform list and search operations.

Does the things CLI support listing projects and areas from Things 3?

Yes, the things CLI supports listing projects and areas from Things 3, providing read-only access to inbox, today, upcoming, and tags directly from the local Things database.

Why use the Things URL scheme instead of direct database access to update tasks?

The Things URL scheme is used to update tasks because it safely handles write operations like adding, completing, and moving items, ensuring data integrity within the local Things database.