Things 3 Manager (CLI)

Quick start

• Ensure Things 3 is installed and opened at least once.
• In Things → Settings → General: enable “Enable Things URLs”.
• Run the CLI (auto-bootstraps .skills-data/things3-manager/venv and installs deps on first run):
  • bash .codex/skills/things3-manager/scripts/things --help
  • bash .codex/skills/things3-manager/scripts/things inbox
  • bash .codex/skills/things3-manager/scripts/things search "weekly review"
  • bash .codex/skills/things3-manager/scripts/things add-todo --title "Book flights" --when today --tag travel --checklist "passport" --checklist "charger"

Operating rules (for Codex)

• Prefer read-only commands first (inbox, today, search, projects, areas, tags) to discover UUIDs and current state.
• Before any write command (add-todo, add-project, update-todo, update-project), summarize the exact changes and confirm with the user.
• If the user provides a project/area/heading by name, resolve it by listing (projects/areas/headings) before writing.