From 9bcde26f85a49519149f2f2e0be99a129c5d4ee0 Mon Sep 17 00:00:00 2001
From: Ryan Lewis <ryan@rlew.io>
Date: Sat, 30 May 2026 16:02:22 +0100
Subject: [PATCH] docs(release): add v0.4.0 release notes header

Headlines the bash/zsh/fish shell completions (#94, #95), notes the lipgloss v2
migration (#93) and dep updates, and folds in the skill-doc changes (#89).

Also removes the orphaned v0.3.2.md header: v0.3.2 was never tagged, and its
sole change (#89) is now covered by the v0.4.0 notes, so we go straight from
v0.3.1 to v0.4.0.
---
 .github/releases/v0.3.2.md | 13 -------------
 .github/releases/v0.4.0.md | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 13 deletions(-)
 delete mode 100644 .github/releases/v0.3.2.md
 create mode 100644 .github/releases/v0.4.0.md

diff --git a/.github/releases/v0.3.2.md b/.github/releases/v0.3.2.md
deleted file mode 100644
index c4e50e5..0000000
--- a/.github/releases/v0.3.2.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## `things-cli` v0.3.2 — fuller bundled skill
-
-Patch release: the in-binary agent skill now spells out flags that were previously hidden behind `...` or missing entirely.
-
-### Change
-
-- `things skill show` (and the installed `SKILL.md`) now documents every flag on `things open` (`-p`/`-a`/`-t`/`-q`/`--filter`/`--background`), and lists `--prepend-notes`/`--append-notes`/`--checklist`/`--prepend-checklist`/`--append-checklist`/`--list-id`/`--heading-id` on `things edit` (and the project-edit equivalents) explicitly instead of trailing `...` (#89)
-
-No CLI behavior changes — only the bundled agent skill text. Reinstall it for your agent of choice (`things skill install claude`, `…codex`, `…pi`) to pick up the new content.
-
-### Requirements
-
-macOS with Things3 installed. Binaries for Apple Silicon (`darwin_arm64`) and Intel (`darwin_amd64`).
diff --git a/.github/releases/v0.4.0.md b/.github/releases/v0.4.0.md
new file mode 100644
index 0000000..88007dd
--- /dev/null
+++ b/.github/releases/v0.4.0.md
@@ -0,0 +1,34 @@
+## `things-cli` v0.4.0 — shell completions
+
+`things <TAB>` now completes subcommands, flags, and enum values in bash, zsh,
+and fish. Homebrew sets it up for you; everyone else runs one line.
+
+### Headline
+
+- **Shell completions** for bash, zsh, and fish (#94, #95). The Homebrew cask
+  generates them on install, so `brew install ryanlewis/tap/things` gives you
+  `things <TAB>` with no extra steps. On other install paths, load them
+  yourself — `source <(things completions bash)`, `source <(things completions
+  zsh)`, or `things completions fish | source`. Completions are driven from the
+  live command tree, so they never drift from the CLI: subcommand names, flag
+  names, and enum values like `--color auto|always|never`.
+
+### Under the hood
+
+- Migrated styling to [lipgloss v2](https://github.com/charmbracelet/lipgloss)
+  (`charm.land/lipgloss/v2`) (#93). No visible change to `list`/`show` output;
+  JSON (`-j`) stays script-stable.
+- Routine dependency updates (#83, #91, #92).
+
+### Docs
+
+- The bundled agent skill (`things skill show` / installed `SKILL.md`) now spells
+  out every `things open` flag (`-p`/`-a`/`-t`/`-q`/`--filter`/`--background`)
+  and the `edit` / `project edit` prepend/append/checklist/`*-id` flags instead
+  of trailing `...` (#89). Reinstall it (`things skill install claude`, `…codex`,
+  `…pi`) to pick up the new text.
+
+### Requirements
+
+macOS with Things3 installed. Binaries for Apple Silicon (`darwin_arm64`) and
+Intel (`darwin_amd64`).