things-mac

Manage Things 3 tasks on macOS via the `things` CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires things, and includes references (resource) components.

What problem does it solve?

This Skill streamlines task management within the Things 3 application on macOS by allowing users to add, update, and query their to-dos via a command-line interface.

Core Features & Use Cases

  • Task Creation: Add new todos with titles, notes, deadlines, and assign them to projects or areas.
  • Task Management: Update existing tasks, mark them as complete or canceled, and modify their details.
  • Data Retrieval: List inbox items, today's tasks, upcoming events, and search for specific tasks within the Things database.
  • Use Case: A user can ask to add "Schedule dentist appointment for next Tuesday" to their "Health" project, and the Skill will handle the creation and organization of this task within Things 3.

Quick Start

Use the things-mac skill to add a new todo with the title "Buy groceries" to your inbox.

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

Manage Things 3 tasks on macOS by using a CLI to add, update, and query todos, projects, and areas. It interacts directly with the Things URL scheme and local database to execute task operations.

Can I add a new todo to a specific Things 3 project from the terminal?

Yes, you can add new todos to specific projects from the terminal. The CLI supports creating tasks with titles, notes, deadlines, and assigning them directly to existing projects or areas within the Things database.

Do I need an authentication token to update Things 3 todos via CLI?

Yes, updating existing todos requires an authentication token. While querying the local database is standard, write operations like modifying or canceling tasks optionally require configuring a database path and token.

What task data can I retrieve from the Things 3 database using this CLI?

You can retrieve inbox items, today's tasks, and upcoming events from the Things database. The CLI also supports searching for specific tasks to help you query and organize your task list efficiently.

What are the limitations of using a CLI for Things 3 task management?

Limitations include requiring the specific things binary to be installed and configured on macOS. Complex visual organization or manual GUI-specific interactions within the Things app are not handled by the CLI.