things3

Manage Things 3 tasks via the Things CLI and URL scheme on macOS.

5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/gabrielkoerich/skills --skill things3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things3
Source: https://github.com/gabrielkoerich/skills/tree/main/things3
Command: npx skills add https://github.com/gabrielkoerich/skills --skill things3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate the management of Things 3 tasks on macOS by driving the Things CLI and URL scheme to read and modify the local Things database.

Core Features & Use Cases

  • Read-only access to the local Things database (inbox, today, upcoming, projects, areas, tags) to surface information.
  • Write operations via the Things URL scheme to add or update todos and organize them into projects, lists, or headings.
  • Use cases include adding a new task to a project, listing today's tasks, searching by tag or project, and inspecting project/area/tag structures.

Quick Start

Ask your agent to add a new task to Things 3 or list today’s tasks using the local Things database.

Frequently Asked Questions about things3

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Things 3 task management from the macOS command line?

The Skill executes things3-cli commands and triggers the Things URL scheme to add, update, list, or search todos within the local Things database. It organizes new tasks into projects, lists, or headings based on your CLI inputs.

Can I list today's tasks and search the Things 3 inbox via CLI?

Yes, you can list today's tasks and search the Things 3 inbox via CLI. The Skill provides read-only access to the local Things database, enabling you to surface inbox items, upcoming tasks, projects, areas, and tags directly from the macOS command line.

Do I need macOS to run things3-cli commands for task automation?

Yes, you need macOS to run things3-cli commands for task automation. The Skill requires macOS-only execution to access the local Things database and utilize the Things URL scheme for updating todos and organizing them into projects.

How does the Things URL scheme handle adding and updating todos?

The Things URL scheme handles adding and updating todos by executing write operations that modify the local Things database. This mechanism allows you to create new tasks and organize them into existing projects, lists, or headings.

Are there limitations when using CLI to modify the local Things database?

Limitations include requiring macOS-only execution and appropriate permissions for updates. While read operations access the local Things database directly, write operations rely on the Things URL scheme, which may require specific access rights to modify tasks.