Things Mac

A command-line interface for Things 3 that lets you read your local database and manipulate todos through the Things URL scheme. You can search, list projects and tags, add todos with notes and checklists, and update existing items if you set up an auth token. The read operations hit the SQLite database directly, so you'll need to grant Full Disk Access to your terminal or OpenClaw. The update commands use Things' URL scheme instead, which means they're safer but require an extra token dance. It's macOS only and written in Go. Honestly most useful if you're already deep in the terminal and want to script todo captures without reaching for the GUI.

skills.sh installs: 2.7K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill things-mac --agent claude-code

Installs into .claude/skills of the current project.

Files

Things 3 CLI

Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.

Setup

Install (recommended, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; OpenClaw.app for gateway runs).
Optional: set THINGSDB (or pass --db) to point at your ThingsData-* folder.
Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.