skills.rest
srgaba
srgabaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

things-mac

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you read and modify your Things 3 task database from the command line on macOS, so an AI assistant can add todos, list your inbox or today view, and search projects without opening the Things app manually. ## Core Features & Use Cases - Read-only database access: List inbox, today, and upcoming tasks, search tasks, and inspect projects, areas, and tags directly from the local Things database. - Write via URL scheme: Add todos with notes, deadlines, tags, checklists, and project/heading placement, and update existing todos (title, notes, tags, completion) using an auth token. - Safe previews: Use --dry-run to print the Things URL without opening the app before committing changes. - Use Case: Ask your assistant to add "Book flights" to your Travel project with a Friday deadline, then list today's tasks to confirm it landed correctly. ## Quick Start Ask the assistant to add a task to Things, for example: add a todo titled "Buy milk" with a note and today's date to my Things inbox.

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 my Things inbox and today tasks in the terminal?▼

Run `things inbox --limit 50` or `things today` to read directly from the local Things database. You can also use `things upcoming`, `things search "query"`, and `things projects` for other views.

Does the things CLI work on Windows or Linux?▼

No, this skill is macOS-only because Things 3 is an Apple-platform app and the CLI reads its local database and uses the macOS URL scheme. The skill metadata explicitly restricts it to darwin.

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 OpenClaw.app for gateway runs, or point `--db`/`THINGSDB` at your ThingsData folder.

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

No, things3-cli does not support deleting or moving todos to trash; `things trash` is read-only. The workaround is marking items with `--completed` or `--canceled` via `things update`, or deleting them in the Things UI.

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
alexisvincentalexisvincent

lops-system

Triage and organize tasks, projects, and inbox items in Linear using a GTD workflow.

Community
Basic
ramirlmramirlm

todo-list-manager

Manage prioritized to-do lists across five life domains with Google Calendar integration.

Community
Advanced
claude-office-skillsclaude-office-skills
368

Apple Shortcuts Integration

Create and execute Apple Shortcuts for iOS and macOS automation.

Official
Intermediate