v1.4.0

Things skill improvements — better triggering, no more AppleScript detours.

• Description rewritten to be authoritative: the things CLI is the only supported way to read or write Things — never osascript/AppleScript or a raw things:/// URL. Adds checklists to the trigger phrases.
• --checklist gotcha note: spells out that Things' AppleScript dictionary has no checklist items element (can't create or read them), so checklists must go through the CLI flags.

No CLI behavior change — skill-content only.

v1.3.2 — plugin-only, drop install.sh

Removed install.sh/uninstall.sh. The skill is delivered by the plugin/marketplace and bin/things is auto-added to PATH there; the launcher self-bootstraps its venv on first run.

v1.3.1 — platform-agnostic invocation, leaner install

SKILL.md/AGENTS.md now just say call things directly (dropped the install.sh/PATH/${CLAUDE_PLUGIN_ROOT} mechanics that nudge an agent into hardcoding a path). install.sh/uninstall.sh only manage the ~/.local/bin/things shell symlink; the skill is delivered by the plugin/marketplace. README puts the plugin first, the shell CLI as an optional extra.

v1.3.0 — checklist editing on update

Add --append-checklist / --prepend-checklist (safe: keep existing items + their completion state) and --checklist (full replace) to the update command. Lets you fill in / edit a todo's checklist without recreating it.

things v1.2.0

Read closed tasks — tasks query + --status

The list views (today/inbox/projects --items) only ever showed open todos — there was no way to read completed/canceled tasks without dropping to raw SQL. Now there is.

New tasks command — the general filter over your todos:

things tasks --project <name|uuid> --status done    # audit what's closed in a project
things tasks --status completed --limit 50          # the logbook
things tasks --area Home --status all
things tasks --tag urgent

--status: incomplete (default) · completed · canceled · done (= completed+canceled) · all. Names auto-resolve to UUIDs; --grep/--limit/--pretty apply as usual.

projects --items --status — control which task statuses are listed per project.

No breaking changes — every existing command defaults to incomplete, exactly as before.

things v1.1.0

Single-instance sync guard

Two copies of the Things app running at once silently stall Things Cloud sync — one instance holds the sync connection and can go stale, so writes still land in the local DB (and the app looks fine) but never reach your other devices, and changes from them never arrive.

• things doctor now checks for this — it flags when more than one Things3 process is running.
• SKILL.md documents the rule, the symptom, and the pgrep -x Things3 check.

No API changes.

v1.0.0 — first release

things-cli — drive Things 3 from your AI agent.

Read inbox / today / projects, search, and add / complete / update todos — all with clean JSON output meant to be consumed by an agent.

• Ships the things skill from a single skills/ source, used the same from Claude Code, Cursor, Codex, Gemini, and OpenCode.
• Packaged with pyproject.toml (PEP 621) — install with uv or pip.
• Self-bootstrapping bin/things launcher: the venv is created lazily on first run.
• Install standalone (./install.sh), as a Claude Code plugin (/plugin install things@things-cli), via OpenCode, or from an aggregate marketplace.