Setting the file. One moment.
Subchapter 1.1
release.mdMarkdown6 KBView on GitHub
A release is a chore: mark v<next-patch> commit whose PR body is the release notes. Example: https://github.com/microsoft/playwright-cli/pull/367 (opens in a new tab).
Bump the patch version in package.json (e.g. 0.1.7 → 0.1.8), then npm install to sync package-lock.json. This is the entry point — everything else (branch name, PR title, release notes filename) keys off the new version.
Find the baseline. The previous release is the last commit on . Read the Playwright version pinned at that commit — that’s the baseline for the diff.
chore: mark v...maingit log --oneline | grep "mark v" | head -1
git show <sha>:package.json | grep '"playwright"'Figure out the playwright commit window. Convert the baseline’s alpha timestamp to a UTC date, and use the new alpha’s date as the upper bound. Alphas are either 1.X.0-alpha-<ms-epoch> or 1.X.0-alpha-<YYYY-MM-DD>.
date -u -d @<seconds> '+%Y-%m-%d %H:%M:%S UTC' # for ms-epoch, divide by 1000 firstList Playwright commits in the window. Run from ~/code/playwright (a local Playwright checkout). --after / --before work on any ref regardless of what origin/main currently points at; --since / --until can silently return empty if the branch is behind.
cd ~/code/playwright && git log --after='<baseline-date>' --before='<new-date>' --pretty=format:'%h %ci %s'Filter to CLI-relevant commits. Keep anything touching the CLI surface or its runtime; drop internal/unrelated churn.
src/tools/cli-client/**, src/tools/cli-daemon/**, src/tools/mcp/**, remote/playwrightConnection, CDP-attach paths, tracing/video APIs the CLI exposes, and anything with a fix(cli) / feat(cli) / fix(mcp) / feat(mcp) prefix.git show --stat <sha> to sanity-check whether a commit’s files touch the CLI.Pull issue context for each kept PR. The PR’s linked issue often has better user-facing wording than the PR/commit title.
gh pr view <pr> --repo microsoft/playwright --json title,body,closingIssuesReferences
gh issue view <issue> --repo microsoft/playwright-cli --json title,body,stateWrite the release notes to RELEASE_NOTES_v<version>.md. Use this exact shape — no top-level # header, the PR title is the heading:
## ✨ Highlights
- **<emoji> <issue wording, not commit wording>** ([microsoft/playwright#<issue>](https://github.com/microsoft/playwright/issues/<issue>)) — the user-facing effect, naming the new commands / flags / config options. ([microsoft/playwright#<pr>](https://github.com/microsoft/playwright/pull/<pr>))
## 🐛 Fixes
- `<commit subject>` — what changed and why it matters. ([#<pr>](https://github.com/microsoft/playwright/pull/<pr>))
## 📦 Upgrading
```bash
npm install -g @playwright/cli@<version>
Example highlight titles: `**🎬 Smooth 60 fps, styleable videos**`, `**🧰 WebMCP tools show up in the snapshot**`, `**🌗 Switch between light and dark color scheme**`, `**📁 Absolute paths in results**`.
Wording rules:
- **Section headings carry their emoji** (`✨ Highlights`, `🐛 Fixes`, `📦 Upgrading`), and **every highlight title starts with one unicode emoji** that fits the feature. No emojis in the Fixes bullets.
- **Order highlights by how exciting they are to a user, not chronologically.** Showy features (video, new commands, new agent capabilities) go first; config knobs go last.
- **Advertise the benefit, not the mechanism**: `video-start --fps=60` records smooth 60 fps videos, not "`--fps <n>` sets a custom frame rate". Use a concrete, copy-pasteable invocation.
- **Don't carry caveats over from the upstream PR description** (browser limitations, "still capped at…"). They are often stale by the time the PR merges — leave them out unless verified.
Commit, push, open PR. The PR body is the contents of the release notes file (no # header, no filename).
git checkout -b mark-v<version>
git add package.json package-lock.json
git commit -m "chore: mark v<version>"
git push -u origin mark-v<version>
gh pr create --repo microsoft/playwright-cli \
--head pavelfeldman:mark-v<version> \
--base main \
--title "chore: mark v<version>" \
--body "$(cat RELEASE_NOTES_v<version>.md)"--since / --until when diffing Playwright — if origin/main in the local checkout is behind, they return empty. --after / --before against the local ref work.# playwright-cli vX.Y.Z header in the PR body — GitHub already renders the PR title.