🎯

things-mac

🎯Skill

from steipete/clawdis

What it does

Manages Things 3 tasks on macOS via CLI, enabling adding, searching, listing, and updating todos directly from the command line.

📦

Part of

steipete/clawdis(48 items)

things-mac

Installation

npm installInstall npm package

npm install -g openclaw@latest

git cloneClone repository

git clone https://github.com/openclaw/openclaw.git

pnpmRun with pnpm

pnpm install

📖 Extracted from docs: steipete/clawdis

Need more details? View full documentation on GitHub →

8Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

Overview

# 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.

Read-only (DB)

things inbox --limit 50
things today
things upcoming
things search "query"
things projects / things areas / things tags

Write (URL scheme)

Prefer safe preview: things --dry-run add "Title"
Add: things add "Title" --notes "..." --when today --deadline 2026-01-02
Bring Things to front: things --foreground add "Title"

Examples: add a todo

Basic: things add "Buy milk"
With notes: things add "Buy milk" --notes "2% + bananas"
Into a project/area: things add "Book flights" --list "Travel"
Into a project heading: things add "Pack charger" --list "Travel" --heading "Before"
With tags: things add "Call dentist" --tags "health,phone"
Checklist: things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
From STDIN (multi-line => title + notes):

- cat <<'EOF' | things add -

- Title line

- Notes line 1

- Notes line 2

- EOF

Examples: modify a todo (needs auth token)

First: get the ID (UUID column): things search "milk" --limit 5
Auth: set THINGS_AUTH_TOKEN or pass --auth-token
Title: things update --id --auth-token "New title"
Notes replace: things update --id --auth-token --notes "New notes"
Notes append/prepend: things update --id --auth-token --append-notes "..." / --prepend-notes "..."
Move lists: things update --id --auth-token --list "Travel" --heading "Before"
Tags replace/add: things update --id --auth-token --tags "a,b" / things update --id --auth-token --add-tags "a,b"
Complete/cancel (soft-delete-ish): things update --id --auth-token --completed / --canceled
Safe preview: things --dry-run update --id --auth-token --completed

Delete a todo?

Not supported by things3-cli right now (no “delete/move-to-trash” write command; things trash is read-only listing).
Options: use Things UI to delete/trash, or mark as --completed / --canceled via things update.

Notes

macOS-only.
--dry-run prints the URL and does not open Things.

More from this repository10

🎯

gog🎯Skill

Manages Gmail, Calendar, Drive, Contacts, Sheets, and Docs via CLI with OAuth-based Google Workspace interactions.

🎯

weather🎯Skill

Retrieves current weather and forecasts for any location using free services, with multiple output formats and no API key required.

🎯

summarize🎯Skill

Quickly summarizes URLs, local files, and YouTube links using AI models with flexible extraction options.

🎯

coding-agent🎯Skill

Runs coding agents like Claude Code or Codex in bash with PTY support, enabling programmatic control and background processing.

🎯

mcporter🎯Skill

Streamlines interaction with MCP servers through CLI, enabling listing, configuration, authentication, and direct tool calls via HTTP or stdio.

🎯

apple-reminders🎯Skill

Manages Apple Reminders via CLI, enabling listing, adding, editing, completing, and deleting tasks with flexible date and list filtering.

🎯

gifgrep🎯Skill

Searches and downloads GIFs from Tenor/Giphy with a CLI/TUI, enabling preview, extraction, and easy sharing.

🎯

nano-pdf🎯Skill

Edits PDFs using natural language instructions, allowing precise page-level modifications with simple CLI commands.

🎯

obsidian🎯Skill

Automates interactions with Obsidian vaults, enabling searching, creating, moving, and managing Markdown notes via obsidian-cli.

🎯

peekaboo🎯Skill

Automates macOS UI interactions by capturing screens, targeting elements, driving input, and managing apps via a powerful CLI tool.