things

Community

Automate Things 3 tasks, effortlessly.

Authorbendrucker
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill automates personal task management in Things 3, allowing you to create, read, update, and organize tasks without manual interaction, saving significant time.

Core Features & Use Cases

  • Comprehensive Task Management: Create, read, update, and navigate todos, projects, areas, and tags.
  • Type-Safe JXA Scripts: Write robust JavaScript for Automation (JXA) scripts using TypeScript for enhanced reliability.
  • Secure Authentication: Manages Things 3 API tokens securely via macOS Keychain for seamless background automation.
  • Use Case: Need to quickly add a complex project with multiple sub-tasks and checklists to Things 3? This Skill can do it with a single command, or even automate daily task reviews.

Quick Start

Create a simple todo for today

open "things:///add?title=Buy%20groceries&when=today&tags=Errands"

Read today's todo count

scripts/run-jxa.sh 'const app = Application("Things3"); const list = app.lists.byId("TMTodayListSource"); console.log(list.toDos().length);'

Dependency Matrix

Required Modules

@jxa/global-type@jxa/run@jxa/sdef-to-dts@types/nodeesbuild

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: things
Download link: https://github.com/bendrucker/claude/archive/main.zip#things

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository