things-mac

Manage Things 3 tasks from the command line via things3-cli Go binary.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/brikkoAI/brikko-studio --skill things-mac-brikkoai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/brikkoAI/brikko-studio/tree/main/packages/core/skills/things-mac
Command: npx skills add https://github.com/brikkoAI/brikko-studio --skill things-mac-brikkoai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

For macOS users who rely on Things 3 as their primary task manager, there is no native way to manage todos, search across projects, or automate task updates without manually interacting with the Things app interface, which slows down productivity workflows.

Core Features & Use Cases

  • Read-only task access: View inbox items, today's tasks, upcoming todos, and full lists of projects, areas, and tags directly from the Things database.
  • Write and update operations: Add new todos with custom notes, deadlines, tags, and list assignments, or modify existing task details without opening the Things app.
  • Use case example: A user can quickly add a work task titled "Prepare client presentation" with a deadline of next Wednesday and the tag "client-work" directly from the command line, or search for all tasks related to a specific project across their entire Things library in seconds.

Quick Start

Use the things-mac skill to add a new todo titled "Buy groceries" with the note "Milk, eggs, bread" and tag it "personal".

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 by using a skill that enables direct read and write access to the local Things database, bypassing the need to manually open the app interface for task updates.

Can I add new todos with deadlines and tags to Things 3 without opening the app?

Yes, you can add new todos to Things 3 without opening the app by executing write operations from the command line, allowing you to set custom notes, deadlines, tags, and list assignments directly.

What are the requirements to automate Things 3 task management on macOS?

Automating Things 3 task management requires installing the things3-cli Go binary, granting Full Disk Access permissions to the calling process, and setting up an optional authentication token for write operations.

How does cross-project task search work in the Things 3 database?

Cross-project task search in the Things 3 database works by querying the local database directly from the command line, retrieving matching tasks across your entire library in seconds without manual UI navigation.

Does this Things 3 automation tool support bulk task creation?

Yes, the Things 3 automation tool supports bulk task creation by leveraging command-line write access to the local database, allowing you to automate the logging of multiple tasks efficiently.

What should I do if my Things 3 command line tool cannot access the task database?

If the Things 3 command line tool cannot access the task database, verify that the calling process has been granted Full Disk Access permissions in macOS settings, as this is required to read the local database.