How do I install the Things3 Manager skill?

Run npx skillmds@latest add diegosouzapw/things3-manager in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Things3 Manager safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Things3 Manager?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Things3 Manager free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Things3 Manager?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Things3 Manager by diegosouzapw — Agent Skill

Name: Things3 Manager
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

Things3 Manager

Manage tasks, projects, areas, headings, and tags in the Things 3 macOS app via a local CLI (list Inbox/Today/Upcoming/Anytime/Someday/Logbook, search, create/update/complete/cancel items, open items in Things). Use when Codex needs to manage Things 3 on macOS.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

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.

Local data and env

Store all mutable state under /.skills-data//.
Keep config and registries in .skills-data// (for example: config.json, .json).
Use .skills-data//.env for SKILL_ROOT, SKILL_DATA_DIR, and any per-skill env keys.
Install local tools into .skills-data//bin and prepend it to PATH when needed.
Install dependencies under .skills-data//venv:
- Python: .skills-data//venv/python
- Node: .skills-data//venv/node_modules
- Go: .skills-data//venv/go (modcache, gocache)
- PHP: .skills-data//venv/php (cache, vendor)
Write logs/cache/tmp under .skills-data//logs, .skills-data//cache, .skills-data//tmp.
Keep automation in /scripts and read SKILL_DATA_DIR (default to /.skills-data//).
Do not write outside and /.skills-data// unless the user requests it.

Commands (CLI)

Lists:
- inbox, today, upcoming, anytime, someday, logbook, trash, recent
Browsing:
- projects, areas, tags, headings, todos, tagged-items
Search:
- search, search-advanced
Writes (via Things URL scheme):
- add-todo, add-project, update-todo, update-project
Open in Things:
- show, search-items

Attribution

CLI implementation is based on things_server.py, url_scheme.py, and formatters.py from https://github.com/hald/things-mcp.

---name: things3-managerdescription: Manage tasks, projects, areas, headings, and tags in the Things 3 macOS app via a local CLI (list Inbox/Today/Upcoming/Anytime/Someday/Logbook, search, create/update/complete/cancel items, open items in Things). Use when Codex needs to manage Things 3 on macOS.---# 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.## Local data and env- Store all mutable state under <project_root>/.skills-data/<skill-name>/.- Keep config and registries in .skills-data/<skill-name>/ (for example: config.json, <feature>.json).- Use .skills-data/<skill-name>/.env for SKILL_ROOT, SKILL_DATA_DIR, and any per-skill env keys.- Install local tools into .skills-data/<skill-name>/bin and prepend it to PATH when needed.- Install dependencies under .skills-data/<skill-name>/venv: - Python: .skills-data/<skill-name>/venv/python - Node: .skills-data/<skill-name>/venv/node_modules - Go: .skills-data/<skill-name>/venv/go (modcache, gocache) - PHP: .skills-data/<skill-name>/venv/php (cache, vendor)- Write logs/cache/tmp under .skills-data/<skill-name>/logs, .skills-data/<skill-name>/cache, .skills-data/<skill-name>/tmp.- Keep automation in <skill-root>/scripts and read SKILL_DATA_DIR (default to <project_root>/.skills-data/<skill-name>/).- Do not write outside <skill-root> and <project_root>/.skills-data/<skill-name>/ unless the user requests it.## Commands (CLI)- Lists: - `inbox`, `today`, `upcoming`, `anytime`, `someday`, `logbook`, `trash`, `recent`- Browsing: - `projects`, `areas`, `tags`, `headings`, `todos`, `tagged-items`- Search: - `search`, `search-advanced`- Writes (via Things URL scheme): - `add-todo`, `add-project`, `update-todo`, `update-project`- Open in Things: - `show`, `search-items`## Attribution- CLI implementation is based on `things_server.py`, `url_scheme.py`, and `formatters.py` from `https://github.com/hald/things-mcp`.

Frequently asked questions