skills.rest
travis-burmaster
travis-burmasterCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

things-mac

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

Updated Feb 16, 2026
Search Tags:#task management#productivity#cli#macos#todo#things 3#url scheme
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill things-mac-travis-burmaster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/things-mac
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill things-mac-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Things 3 tasks from the command line or an AI agent normally requires manual app interaction; this Skill lets you read your local Things database and add or update todos programmatically on macOS. ## Core Features & Use Cases - Read Tasks: List inbox, today, and upcoming items, search tasks, and inspect projects, areas, and tags directly from the local Things database. - Create Todos: Add tasks with notes, deadlines, tags, checklists, and project/heading placement via the Things URL scheme, with a --dry-run preview mode. - Update Todos: Modify titles, notes, tags, lists, and completion status using a Things auth token. - Use Case: Ask your agent to add "Book flights" to your Travel project with a Friday deadline, then list today's tasks to confirm it was scheduled. ## Quick Start Ask the agent to add a task like "Buy milk" to Things 3 and then show your today list.

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 task to Things 3 from the command line?▼

Use the things CLI add command, for example: things add "Buy milk" --notes "2%" --when today. It builds a Things URL scheme call, and you can preview it safely with --dry-run before opening Things.

How do I list or search Things 3 tasks from the terminal?▼

Run things inbox, things today, or things upcoming to list tasks, and things search "query" to find specific items. These read directly from the local Things database and return results including task UUIDs.

Why do Things database reads fail with permission errors?▼

Reads fail when the calling app lacks Full Disk Access on macOS. Grant Full Disk Access to Terminal for manual runs or to the host app for agent runs, and optionally set THINGSDB to point at your ThingsData folder.

Can I update or complete a Things 3 task from the CLI?▼

Yes, use things update --id <UUID> with a Things auth token passed via --auth-token or the THINGS_AUTH_TOKEN environment variable. You can change titles, notes, tags, lists, and mark tasks completed or canceled.

Can the things CLI delete a todo in Things 3?▼

No, things3-cli does not support deleting or moving tasks to trash; things trash is read-only. Delete tasks in the Things UI, or mark them completed or canceled via things update instead.

Does the things CLI work on Linux or Windows?▼

No, this Skill is macOS-only because Things 3 and its local database exist only on Apple platforms. The Skill metadata explicitly restricts it to darwin systems.

Related Skills

Explore More Personal & Entrepreneur Skills→
nweiinweii
7

sync-things-tasks

Synchronize Obsidian note action items to Things 3 tasks via Things CLI.

Community
Intermediate
whmathews15whmathews15
1

daily-plan

Generates a daily plan from calendar events, tasks, meetings, and weekly priorities.

Community
Advanced
zocomputerzocomputer
45

syllabus-reminders

Parse syllabi to extract assignment due dates and create SMS reminders and Google Calendar events.

Official
Intermediate
hmzainjamilhmzainjamil
1

Apple Shortcuts Integration

Automates Apple ecosystem workflows by triggering shortcuts, reminders, notes, and calendar actions on iOS and macOS devices.

Community
Intermediate