ai/skills/things3/SKILL.md
Manage Things 3 tasks, projects, and lists via CLI
npx skillsauth add kurko/dotfiles things3Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use the things3 command to manage Things 3 tasks. This avoids raw osascript
calls which trigger per-invocation permission prompts.
things3 today # Today's tasks
things3 inbox # Inbox
things3 upcoming # Upcoming tasks
things3 anytime # Anytime tasks
things3 someday # Someday tasks
things3 logbook # Completed tasks
things3 logbook --period 7d --limit 20
things3 trash # Trashed tasks
things3 todos # All todos
things3 todos --project "Project Name"
things3 projects # All projects
things3 areas # All areas
things3 tags # All tags
things3 tagged "tag name" # Items with a specific tag
things3 headings # All headings
things3 headings --project "Project Name"
things3 search "query" # Search todos by text
things3 search-advanced --status completed --tag "work"
things3 recent 3d # Items created in last 3 days
things3 add "Task title"
things3 add "Task title" --when today --tags "work,urgent"
things3 add "Task title" --notes "Details" --deadline 2026-12-31
things3 add "Task title" --checklist "Step 1,Step 2,Step 3"
things3 add "Task title" --project "Project Name" --heading "Section"
things3 add-project "Project title"
things3 add-project "Project title" --notes "Description" --area "Work"
things3 update UUID --title "New title"
things3 update UUID --completed
things3 update UUID --when tomorrow --add-tags "urgent"
things3 update-project UUID --completed
things3 show UUID # Open item in Things
things3 search-ui "query" # Open search in Things
Each item shows: title, notes, dates, tags, project, checklist, and UUID.
The UUID is needed for update, update-project, and show commands.
The --when flag accepts: today, tomorrow, evening, tonight,
anytime, someday, or a date in YYYY-MM-DD format.
data-ai
Merge the current worktree branch into main and sync main back. Use when the user says "merge to main", "ship it", "merge and continue", or after completing a task in a worktree and wanting to continue with the next one.
tools
Synchronize AI agent skills, commands, configs, permissions, hooks, and instructions across Claude Code, Codex CLI, and other Agent Skills-compatible tools. Use when the user asks to pull skills from Claude into Codex, sync Codex work back to Claude, migrate agent commands, reconcile frontmatter, update permissions, or keep agent setup files in parity.
testing
Write or update UI-independent use cases for QA. Use when the user says "write use cases", "add use cases", "QA use cases", "update use cases", "compose use cases", or when starting implementation of a new feature (after plan approval). Also activates for "what should we test", "regression cases", or "use cases for QA".
documentation
Skill on how to write a task. Use when user asks you to write a task (for Asana, Linear, Jira, Notion and equivalent). Also activates when user says "create task", "write task", or similar task creation workflow requests.