Skip to content

danielh-official/ThingsTagManager

Repository files navigation

Things Tag Manager

A macOS app for managing tags in Things 3. Import, create, rename, reparent, and delete tags — with a clean split-view UI and full hierarchy support.

App Screenshot

Requirements

  • macOS 15+
  • Things 3 (must be running for any write/import operations)
  • Xcode 15+

Features

  • Import all tags from Things 3 into a local list (including parent/child hierarchy)
  • Search tags by name
  • Create new tags with an optional parent
  • Edit tag names and parent assignments
  • Delete tags (also deletes child tags in Things 3)
  • View in Things deep-link to jump to a tag in Things 3

How It Works

The app communicates with Things 3 via AppleScript. Tags are cached locally in a SwiftData store and treated as a snapshot — importing from Things replaces all local tags.

Building

Open ThingsTagManager.xcodeproj in Xcode and run (Cmd+R).

Running Tests

xcodebuild test -project ThingsTagManager.xcodeproj -scheme ThingsTagManager -destination 'platform=macOS'

License

MIT — see LICENSE.