things-cli

Manage Things 3 tasks via command-line interface and URL schemes.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/builtby-win/skills --skill things-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-cli
Source: https://github.com/builtby-win/skills/tree/main/skills/things-cli
Command: npx skills add https://github.com/builtby-win/skills --skill things-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires things-cli, osascript, python3, open, and includes scripts (resource) and references (resource) and evals (resource) components.

What problem does it solve?

This Skill allows users to interact with their Things 3 tasks, projects, and areas directly from a command-line interface, streamlining task management for terminal-centric workflows.

Core Features & Use Cases

  • Read & Search: Query inbox, today, upcoming, deadlines, and search for specific items.
  • Create & Update: Add new to-dos and projects, or modify existing ones using Things URLs.
  • Delete & Trash: Safely remove items using AppleScript.
  • Use Case: Quickly add a new task with specific tags and a deadline, or search for all tasks related to a project without leaving your terminal.

Quick Start

Use the things-cli skill to add a task to Things 3 for "Buy groceries" with tags "errands" and "shopping".

Frequently Asked Questions about things-cli

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

FAQPage Schema
How do I manage Things 3 tasks from the terminal?

Things 3 tasks can be managed from the terminal via a command-line interface that uses AppleScript and Python helpers to execute task management operations like reading, creating, and deleting items.

Can I create Things 3 to-dos with tags and deadlines using a CLI?

Yes, you can add new to-dos with specific tags and deadlines to Things 3 by executing CLI commands that construct and trigger Things URL schemes.

Does the Things 3 CLI tool work on macOS?

The Things 3 CLI tool works on macOS, relying on native osascript and Python helpers to interact with the Things 3 application installed on the system.

What is the best way to search for tasks in Things 3 from the command line?

The best way to search for tasks in Things 3 from the command line is using the CLI's query functions to read and search inbox, today, upcoming, and deadline views for specific items.

How do I delete or trash items in Things 3 using AppleScript?

To delete or trash items in Things 3 using AppleScript, the CLI executes osascript commands that safely remove specified tasks from your Things 3 database.

Do I need Python to use the Things 3 command line interface?

Yes, you need Python3 installed because the Things 3 command line interface uses Python helpers alongside osascript and the open command to process task management operations.