things-mac

Manage Things 3 tasks and projects on macOS via the things CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline macOS workflows by controlling Things 3 from the command line: read, search, and list tasks from the local Things database, and add or update todos via the Things URL scheme.

Core Features & Use Cases

  • Read and query the local Things database (inbox, today, upcoming, projects, areas, and tags).
  • Add or update tasks using the Things CLI from the terminal, including URL-scheme driven updates.
  • Use case: quickly add a task or search for a project without opening the Things app.

Quick Start

Use the things CLI on macOS to manage Things tasks directly from the 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 using the things CLI to read the local database and execute URL scheme commands for adding or updating todos.

Can I search my Things 3 inbox and upcoming tasks without opening the app?

Yes, you can search your Things 3 inbox, today, and upcoming tasks directly in the terminal by querying the local Things database via the things CLI without opening the app.

Do I need the Go-based things CLI binary to add todos via the Things URL scheme?

Yes, adding or updating todos via the Things URL scheme on macOS requires the Go-based things CLI binary and appropriate local database access permissions.

What's the best way to automate Things 3 task management on macOS?

The best way to automate Things 3 task management on macOS is using the things CLI to read lists, search tasks, and apply URL scheme updates directly from terminal scripts.

Does the things CLI require specific database access permissions on macOS?

Yes, the things CLI requires appropriate database access permissions to read the local Things database, with optional configuration available for specifying the DB path.

Why use a CLI approach instead of direct Things 3 app interaction for task management?

Using a CLI approach streamlines macOS workflows by allowing rapid task searching and adding via the URL scheme without the overhead of manually opening and navigating the Things 3 app.