cyberneticlibrary

Manage Things 3 todos from CLI

things-macskillsetup L2377,536
openclaw/openclaw
What it does

Read and write Things 3 todos, projects, areas, and tags from CLI

Best for

Automation scripts adding, searching, and updating Things 3 todos directly without GUI (e.g., email-to-todo, task ingestion, bulk operations).

Inputs
  • · Query string (search), project/area name, or todo UUID
  • · Title, notes, tags, list name, deadline for new todos
Outputs
  • · Todos list with UUID, project/area list, or confirmation of created/updated todo
Requires
  • · things3-cli (Go binary)
  • · Things 3 macOS app with accessible database
Preconditions
  • · Things 3 installed and database accessible
  • · Full Disk Access granted to terminal or runner app
  • · Auth token set for write operations
Failure modes
  • · Database not accessible without Full Disk Access permission
  • · Invalid todo UUID causes lookup failure
  • · Write operations require THINGS_AUTH_TOKEN (no fallback)
  • · Trash/delete not supported (only mark completed or canceled)
Trust signals
  • · Uses official things3-cli from ossianhempel/things3-cli
  • · Supports checklist items, nested projects, and project headings
  • · --dry-run for safe preview before executing URL scheme