things-mac

Manage Things 3 tasks from the macOS command line using the things CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/estebanrfp/genos --skill things-mac-estebanrfp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/estebanrfp/genos/tree/main/skills/things-mac
Command: npx skills add https://github.com/estebanrfp/genos --skill things-mac-estebanrfp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing tasks in Things 3 on macOS can be fragmented between the app and external workflows. This Skill enables you to control Things 3 from the command line, allowing quick task creation, search, and listing without leaving your terminal.

Core Features & Use Cases

  • Add tasks to Things from scripts or prompts using the CLI installed via Go.
  • List and search tasks, inbox, today, upcoming, and projects locally in Things.
  • URL-scheme updates and project management via the Things database, for automation and batch operations.

Quick Start

Install the CLI, then use the resulting binary to manage your Things tasks from your terminal.

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 installing the things CLI, which allows you to add, search, and list tasks directly from your terminal using URL schemes.

Can I add tasks to Things 3 using a CLI?

Yes, you can add tasks to Things 3 using the CLI by applying write operations via URL schemes, optionally requiring configuration of THINGSDB and THINGS_AUTH_TOKEN for authentication.

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

Yes, you need a macOS environment with the Things app installed and the things CLI binary installed via Go to read and write to the local Things database.

What's the best way to list and search tasks in Things 3 locally?

The best way to list and search tasks in Things 3 locally is by using the things CLI to query your inbox, today, upcoming, and projects directly from the Things local database.

Why does the things CLI require THINGS_AUTH_TOKEN for write operations?

The things CLI requires THINGS_AUTH_TOKEN for write operations to authenticate URL-scheme updates and project management requests, ensuring secure batch automation and database modifications.