things-mac_skill

This skill helps you manage Things 3 on macOS via CLI, enabling read, search, add, and update of tasks, projects, and areas.

TypeScript

0

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill nweii/agent-stuff --skill things-mac

SKILL.md3.9 KB

Overview

This skill lets you manage Things 3 on macOS from the command line. It reads your local Things database (inbox, today, projects, areas, tags, search) and creates or updates todos using Things URL scheme. Use it for fast task inspection, scripted imports, and safe previewing of changes before they open Things.

How this skill works

The skill invokes the native things CLI to read the ThingsData DB or to build Things URL commands. Read-only operations query the local database (inbox, today, upcoming, projects, areas, tags, search). Write operations construct and optionally open Things URL actions, or use the auth token for direct updates. A --dry-run mode prints the resulting URL instead of opening Things.

When to use it

Quickly list your inbox, today, upcoming, or projects from a terminal or agent workflow
Search tasks or inspect a project/area by name to find IDs and details
Add new todos with notes, checklists, tags, schedule, or repeating rules from scripts
Update or move tasks (title, notes, tags, list, heading) when you have the auth token
Automate bulk imports or tool integrations that need safe preview before pushing to Things

Best practices

Install via Homebrew or Go and verify with which things before use
Set THINGSDB if you use nonstandard ThingsData path, otherwise use default detection
Export THINGS_AUTH_TOKEN to your shell for update/delete operations; keep it secret
Use --dry-run to verify URL and intent before opening Things or running updates
Prefer marking completed/canceled over deleting when possible; delete prompts confirmation or use --confirm for scripts

Example use cases

List today’s tasks for a daily standup script: things today
Add a task with notes and tags from a CI step: things add "Deploy prep" --notes "Run tests" --tags "deploy,ops" --dry-run
Find a task’s UUID to update it: things search "invoice" --limit 5 then things update --id <UUID> --auth-token <TOKEN> --completed
Create a project and add tasks into a specific heading: things add-project "Roadmap" --area "Work" then things add "Design review" --list "Roadmap" --heading "Phase 1"
Script recurring reminders: things add "Daily standup" --repeat day --repeat-mode schedule --when today

FAQ

No. Read-only DB queries work without opening the app. Adding or URL-based actions may open Things unless you use --dry-run.

How do I make updates non-interactive?

Set THINGS_AUTH_TOKEN and use --confirm for delete operations. Use --dry-run to validate before non-interactive runs.