things3-manager

Manage Things 3 tasks and projects via a local macOS CLI.

18|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/eugenepyvovarov/things3-agent-skill --skill things3-manager-eugenepyvovarov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things3-manager
Source: https://github.com/eugenepyvovarov/things3-agent-skill/tree/main
Command: npx skills add https://github.com/eugenepyvovarov/things3-agent-skill --skill things3-manager-eugenepyvovarov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires things-py, and includes scripts (resource) components.

What problem does it solve?

Manage tasks, projects, areas, headings, and tags in the Things 3 macOS app via a local CLI, enabling programmatic control and automated workflows from Codex.

Core Features & Use Cases

  • List Inbox/Today/Upcoming/Anytime/Someday/Logbook along with projects, areas, tags, and headings.
  • Search by title/notes with support for advanced filters; browse and extract context.
  • Create, update, complete, or cancel todos and projects via Things URL scheme, including open-in-Things actions.
  • Open lists or items in Things, or summarize current state for human-in-the-loop decision making.
  • Local state management and safe write-first workflow: read-only discovery before applying changes, with optional dry-run.

Quick Start

Install Things 3 URL support and run the CLI under your Codex project to manage your Things items.

Frequently Asked Questions about things3-manager

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

FAQPage Schema
How do I manage Things 3 tasks and projects from the command line?

Things 3 task and project management can be automated from the command line using a local CLI that lists, searches, creates, updates, and completes items via the Things URL scheme. It enables programmatic control over macOS tasks.

Can I use a Python CLI to automate Things 3 task management?

Yes, you can automate Things 3 task management using a Python CLI built on the things-py library. It runs in a Python virtual environment to interact with Things lists, projects, areas, and tags.

How do I search and list Things 3 inbox and upcoming items via CLI?

You can search and list Things 3 inbox, today, upcoming, and anytime items via CLI commands that extract context using advanced filters. The CLI supports read-only discovery to browse titles and notes before making changes.

Does the Things 3 CLI support safe dry-run workflows for task updates?

The Things 3 CLI supports a safe write-first workflow by performing read-only discovery before applying changes, with an optional dry-run mode. State is managed locally under a .skills-data directory to ensure safe operations.

What do I need to run a Things 3 automation script on macOS?

To run Things 3 automation scripts on macOS, you need the Things 3 app installed with URL scheme support, Python, and the things-py library. The CLI operates locally under your Codex project to manage items.

How do I open Things 3 lists or items directly from a script?

You can open Things 3 lists or specific items directly from a script using the Things URL scheme integration. The CLI supports open-in-Things actions to navigate quickly from command line outputs to the GUI.