skills.rest
Yogi-076
Yogi-076COMMUNITY
Explore all skills by this author →
GitHub

things-mac

Manage Things 3 tasks and read the local database via the things CLI.

Updated Mar 13, 2026
Search Tags:#automation#productivity#cli#macos#tasks#todo#things3
One-click install
npx skills add https://github.com/Yogi-076/Vajrascan.on --skill things-mac-yogi-076
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/Yogi-076/Vajrascan.on/tree/main/moltbot/skills/things-mac
Command: npx skills add https://github.com/Yogi-076/Vajrascan.on --skill things-mac-yogi-076

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a reliable interface for adding, updating, searching, and listing Things 3 tasks from an assistant by using the Things CLI and the local Things database, removing the friction of manual entry and navigation in the Things app.

Core Features & Use Cases

  • Read local Things database entries such as inbox, today, upcoming, projects, areas, and tags for reporting or assistant-driven summaries.
  • Add and update todos using the Things URL scheme via the things CLI, including setting notes, tags, project/list, headings, checklists, deadlines, and completion state.
  • Support safe previews with dry-run mode, require THINGS_AUTH_TOKEN for write operations, and handle Full Disk Access and optional THINGSDB path configuration for database reads.
  • Use cases include asking the assistant to add a quick task to a project, search for tasks matching a query, list today's todos, or programmatically mark items completed.

Quick Start

Add a todo titled Buy milk with notes 2% + bananas, tag it groceries, place it in the Travel project, and set the due date to tomorrow.

Frequently Asked Questions about things-mac

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

FAQPage Schema
How do I add a Things 3 task from the macOS command line?▼

List Things 3 inbox, today, and upcoming tasks by reading the local Things database via the things CLI, which requires Full Disk Access on macOS to retrieve and report current todo entries.

Can I use the things CLI to search Things 3 projects and tags?▼

Update Things 3 todos by using the things CLI URL scheme to modify notes, tags, deadlines, and completion state, requiring the THINGS_AUTH_TOKEN environment variable to authorize write operations.

Why does reading the Things database require Full Disk Access on macOS?▼

Reading the Things database requires Full Disk Access because macOS restricts applications and CLI tools from accessing local database files without explicit permission, ensuring secure retrieval of inbox and upcoming tasks.

Do I need THINGS_AUTH_TOKEN to mark Things 3 todos as completed?▼

Marking Things 3 todos as completed requires the THINGS_AUTH_TOKEN environment variable for write operations, while reading the database only needs Full Disk Access and optional THINGSDB path configuration.

Related Skills

Explore More Personal & Entrepreneur Skills→
enclawedenclawed
2

things-mac

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

Community
Intermediate
adiytharpansaadiytharpansa

things-mac

Create, update, and retrieve Things 3 tasks via the local database and URL scheme.

Community
Intermediate
MOODMNKY-LLCMOODMNKY-LLC

things-mac

Manage Things 3 tasks and todos via command line.

Community
Intermediate
riethmayerriethmayer
2

things-mac

Automate Things 3 task management on macOS via the things CLI and URL scheme.

Community
Intermediate