Things CLI

Overview

Use this skill to interact with Things 3 safely from a CLI-driven agent session.

Treat the available integration surfaces as different tools with different jobs:

• things-cli is the preferred read/search/export surface. It is read-only.
• Things URL commands are the preferred create/update surface for to-dos and projects.
• AppleScript is the preferred delete/trash and Mac-only fallback surface.
• Shortcuts is optional when the user already wants a Shortcuts-based workflow.

The critical constraint is simple: do not pretend things-cli can mutate data. It cannot.

When To Use

Use this skill when the user wants to:

• add a task, project, heading, checklist, tag, or note in Things 3
• search Things data from the terminal