docs(changelog): title every release and require one

Every release file now carries a title: two to six plain words naming the
change a user would remember it for. The generator refuses a release without
one, promote carries the title from unreleased.md, and the unreleased
template opens with a title line. The changelog-authoring skill and the
format README describe how to write it.

Claude-Session: https://claude.ai/code/session_01VqV56Hez25hTxXH4ipJfzH

.agents/skills/changelog-authoring/SKILL.md

@@ -11,7 +11,7 @@ The changelog is written once per release, by the maintainer, as one story. Both
 
 Write `changelog/unreleased.md` and nothing else. `CHANGELOG.md`, `packages/vscode/CHANGELOG.md`, and `changelog/index.json` are generated from `changelog/*.md`; after editing run `bun run changelog:build` and commit the source with the regenerated files (`changelog/README.md` describes the file format, `bun run changelog:check` verifies the outputs). The version header, date, and file promotion happen at release time through `oc-dev create-release`, never by hand.
 
-`unreleased.md` holds two sections:
+`unreleased.md` opens with a `title:` front matter line (see The title) and holds two sections:
 
 - `## App` — Web, Desktop, Mobile/PWA, shared UI.
 - `## VS Code` — the extension only, written separately (see below).
@@ -44,6 +44,25 @@ Where a change goes:
 
 The generator emits the groups in this order whatever order the source lists them, drops empty ones, and writes the `## [x.y.z] - YYYY-MM-DD` header that the update dialog, the release workflow, and the website match by regex.
 
+## The title
+
+Every release carries a one-line `title:` in its front matter. The website lists it beside the version and uses it as the heading of the release page, so it is the one line most people read. It answers "what would a user remember this release for":
+
+- **Two to six words** naming the change most users will notice. For a fix-only patch, name what works again: `Terminal works again on Windows`, `Faster session switching`.
+- **Plain words, sentence case**; product names keep their casing. No area prefix with a colon, no trailing period, no version number, no credit.
+- **Never a category alone** (`Fixes`, `Stability`, `Improvements`, `Polish`) and **never a bare area** (`Git`, `Chat`): the title has to teach the reader something.
+- Two headliners at most, joined with `and`, and only when the release really has two.
+
+The generator refuses a release without a title. In `unreleased.md` it sits at the top:
+
+```markdown
+---
+title: Comments on code in VS Code
+---
+
+## App
+```
+
 ## The bullet
 
 The reader is a user of the app. They never opened the code, they will not open the PR, and they give a bullet about five seconds. Write for that reader:
@@ -106,4 +125,5 @@ Read each finished section top to bottom and check every bullet:
 - Empty groups are absent; present groups appear in the order New, Improvements, Fixes, Misc.
 - It appears only in the section whose runtime receives it.
 - Its contributor is credited.
+- The `title:` line names the release's headline change in two to six plain words.
 - `bun run changelog:build` ran and the regenerated files are staged with the source.

changelog/1.0.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.1
 date: 2025-12-07
+title: OpenChamber public release
 ---
 
 ## App

changelog/1.0.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.2
 date: 2025-12-07
+title: Refined macOS window design
 ---
 
 ## App

changelog/1.0.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.3
 date: 2025-12-07
+title: Refreshed onboarding and sidebar
 ---
 
 ## App

changelog/1.0.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.4
 date: 2025-12-07
+title: Faster desktop app startup
 ---
 
 ## App

changelog/1.0.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.5
 date: 2025-12-07
+title: Older messages load without jumping
 ---
 
 ## App

changelog/1.0.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.6
 date: 2025-12-08
+title: Better shell environment detection
 ---
 
 ## App

changelog/1.0.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.7
 date: 2025-12-08
+title: Smoother app updates
 ---
 
 ## App

changelog/1.0.8.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.8
 date: 2025-12-08
+title: More reliable OpenCode CLI detection
 ---
 
 ## App

changelog/1.0.9.md

@@ -1,6 +1,7 @@
 ---
 version: 1.0.9
 date: 2025-12-08
+title: Changelog shown in update dialog
 ---
 
 ## App

changelog/1.1.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.0
 date: 2025-12-13
+title: VS Code extension and answer forking
 ---
 
 ## App

changelog/1.1.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.1
 date: 2025-12-13
+title: User messages render correctly again
 ---
 
 ## App

changelog/1.1.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.2
 date: 2025-12-13
+title: VS Code extension moves to the activity bar
 ---
 
 ## App

changelog/1.1.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.3
 date: 2025-12-14
+title: Line wrap toggle in diff view
 ---
 
 ## App

changelog/1.1.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.4
 date: 2025-12-15
+title: Flexoki syntax highlighting
 ---
 
 ## App

changelog/1.1.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.5
 date: 2025-12-15
+title: Fuzzy search for file mentions
 ---
 
 ## App

changelog/1.1.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.1.6
 date: 2025-12-15
+title: Redesigned session unlock screen
 ---
 
 ## App

changelog/1.10.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.10.0
 date: 2026-05-05
+title: Embedded preview for dev servers
 ---
 
 ## App

changelog/1.10.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.10.1
 date: 2026-05-06
+title: Git sync and stash management
 ---
 
 ## App

changelog/1.10.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.10.2
 date: 2026-05-07
+title: Clone repositories when adding a project
 ---
 
 ## App

changelog/1.10.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.10.3
 date: 2026-05-08
+title: Mini Chat windows
 ---
 
 ## App

changelog/1.10.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.10.4
 date: 2026-05-09
+title: Reuse local branches for PR worktrees
 ---
 
 ## App

changelog/1.11.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.0
 date: 2026-05-14
+title: In-app OpenCode updates and offline dictation
 ---
 
 ## App

changelog/1.11.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.1
 date: 2026-05-15
+title: Session switcher in the chat header
 ---
 
 ## App

changelog/1.11.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.2
 date: 2026-05-18
+title: Collapsible thinking and inline commit diffs
 ---
 
 ## App

changelog/1.11.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.3
 date: 2026-05-19
+title: Skills in slash command autocomplete
 ---
 
 ## App

changelog/1.11.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.4
 date: 2026-05-22
+title: Composer snippets and Electron by default
 ---
 
 ## App

changelog/1.11.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.5
 date: 2026-05-25
+title: Rename sessions inline
 ---
 
 ## App

changelog/1.11.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.6
 date: 2026-05-25
+title: Manage OpenCode plugins from settings
 ---
 
 ## App

changelog/1.11.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.11.7
 date: 2026-05-27
+title: Commit branch graphs and restored streaming
 ---
 
 ## App

changelog/1.12.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.12.0
 date: 2026-06-03
+title: A new default mobile app
 ---
 
 ## App

changelog/1.12.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.12.1
 date: 2026-06-03
+title: Changed-file chips in chat
 ---
 
 ## App

changelog/1.12.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.12.2
 date: 2026-06-05
+title: Windows app now available
 ---
 
 ## App

changelog/1.12.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.12.3
 date: 2026-06-05
+title: Works with OpenCode 1.15 again
 ---
 
 ## App

changelog/1.12.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.12.4
 date: 2026-06-11
+title: Menu bar tray and review sessions
 ---
 
 ## App

changelog/1.13.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.0
 date: 2026-06-15
+title: Remote access password and diff staging
 ---
 
 ## App

changelog/1.13.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.1
 date: 2026-06-17
+title: Cron expressions for scheduled tasks
 ---
 
 ## App

changelog/1.13.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.2
 date: 2026-06-18
+title: Smoother streaming in long chats
 ---
 
 ## App

changelog/1.13.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.3
 date: 2026-06-24
+title: Sign commits with SSH
 ---
 
 ## App

changelog/1.13.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.4
 date: 2026-06-27
+title: Automatic review loops
 ---
 
 ## App

changelog/1.13.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.5
 date: 2026-06-27
+title: The CLI and tunnels work again
 ---
 
 ## App

changelog/1.13.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.6
 date: 2026-06-28
+title: A Dock badge for unseen chats
 ---
 
 ## App

changelog/1.13.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.7
 date: 2026-06-28
+title: The update command works again
 ---
 
 ## App

changelog/1.13.8.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.8
 date: 2026-06-29
+title: Faster startup and safer OpenCode detection
 ---
 
 ## App

changelog/1.13.9.md

@@ -1,6 +1,7 @@
 ---
 version: 1.13.9
 date: 2026-07-02
+title: Native iOS and Android apps arrive
 ---
 
 ## App

changelog/1.14.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.14.0
 date: 2026-07-05
+title: Voice dictation and a compact mobile composer
 ---
 
 ## App

changelog/1.14.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.14.1
 date: 2026-07-07
+title: Recaps and suggested replies in chat
 ---
 
 ## App

changelog/1.15.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.15.0
 date: 2026-07-10
+title: Private relay and a public mobile beta
 ---
 
 ## App

changelog/1.16.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.16.0
 date: 2026-07-13
+title: Session goals and faster remote access
 ---
 
 ## App

changelog/1.16.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.16.1
 date: 2026-07-14
+title: Prompt Navigator and a faster sidebar
 ---
 
 ## App

changelog/1.16.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.16.2
 date: 2026-07-18
+title: A rebuilt terminal and pinned messages
 ---
 
 ## App

changelog/1.16.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.16.3
 date: 2026-07-22
+title: Office attachments and faster session switching
 ---
 
 ## App

changelog/1.17.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.17.0
 date: 2026-07-28
+title: Context panel and redesigned sidebar
 ---
 
 ## App

changelog/1.17.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.17.1
 date: 2026-07-29
+title: Live output in Bash tool cards
 ---
 
 ## App

changelog/1.17.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.17.2
 date: 2026-08-01
+title: OpenChamber theme by default
 ---
 
 ## App

changelog/1.18.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.18.0
 date: 2026-08-04
+title: Guided diff walkthroughs
 ---
 
 ## App

changelog/1.18.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.18.1
 date: 2026-08-04
+title: OAuth provider sign-in works again
 ---
 
 ## App

changelog/1.18.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.18.2
 date: 2026-08-10
+title: Observability panel and scheduled tasks
 ---
 
 ## App

changelog/1.18.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.18.3
 date: 2026-08-14
+title: Agents can browse the web
 ---
 
 ## App

changelog/1.18.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.18.4
 date: 2026-08-14
+title: More stable server and correct message order
 ---
 
 ## App

changelog/1.19.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.19.0
 date: 2026-08-19
+title: Claude usage limits and project knowledge
 ---
 
 ## App

changelog/1.2.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.0
 date: 2025-12-15
+title: Favorite models and adjustable font size
 ---
 
 ## App

changelog/1.2.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.1
 date: 2025-12-16
+title: Todo tracking row in chat
 ---
 
 ## App

changelog/1.2.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.2
 date: 2025-12-17
+title: Live progress for agent tasks
 ---
 
 ## App

changelog/1.2.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.3
 date: 2025-12-17
+title: Image previews in the Diff tab
 ---
 
 ## App

changelog/1.2.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.4
 date: 2025-12-18
+title: Smoother mobile terminal scrolling
 ---
 
 ## App

changelog/1.2.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.5
 date: 2025-12-19
+title: Redesigned Git tab layout
 ---
 
 ## App

changelog/1.2.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.6
 date: 2025-12-19
+title: File previews in permission cards
 ---
 
 ## App

changelog/1.2.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.7
 date: 2025-12-19
+title: Keyboard shortcuts help menu
 ---
 
 ## App

changelog/1.2.8.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.8
 date: 2025-12-19
+title: Update the web app without the CLI
 ---
 
 ## App

changelog/1.2.9.md

@@ -1,6 +1,7 @@
 ---
 version: 1.2.9
 date: 2025-12-20
+title: Automatic session cleanup
 ---
 
 ## App

changelog/1.20.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.20.0
 date: 2026-08-23
+title: Side questions with /btw
 ---
 
 ## App

changelog/1.21.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.21.0
 date: 2026-08-26
+title: Comments on chat replies and redesigned shortcuts
 ---
 
 ## App

changelog/1.21.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.21.1
 date: 2026-08-29
+title: Turkish interface and safer worktree moves
 ---
 
 ## App

changelog/1.22.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.22.0
 date: 2026-08-30
+title: Linear integration and multi-repo git
 ---
 
 ## App

changelog/1.3.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.0
 date: 2025-12-21
+title: Revert chat messages
 ---
 
 ## App

changelog/1.3.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.1
 date: 2025-12-22
+title: New app icon and no more empty chats
 ---
 
 ## App

changelog/1.3.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.2
 date: 2025-12-22
+title: Directory switching no longer breaks sessions
 ---
 
 ## App

changelog/1.3.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.3
 date: 2025-12-25
+title: More reliable VS Code extension startup
 ---
 
 ## App

changelog/1.3.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.4
 date: 2025-12-25
+title: Diff view loads reliably on large files
 ---
 
 ## App

changelog/1.3.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.5
 date: 2025-12-26
+title: Faster workspace switching and fuzzy file search
 ---
 
 ## App

changelog/1.3.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.6
 date: 2025-12-27
+title: Connect and disconnect providers in settings
 ---
 
 ## App

changelog/1.3.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.7
 date: 2025-12-28
+title: Redesigned settings with mobile navigation
 ---
 
 ## App

changelog/1.3.8.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.8
 date: 2025-12-29
+title: Intel Mac support and message queuing
 ---
 
 ## App

changelog/1.3.9.md

@@ -1,6 +1,7 @@
 ---
 version: 1.3.9
 date: 2025-12-30
+title: Skills management and catalog
 ---
 
 ## App

changelog/1.4.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.0
 date: 2026-01-01
+title: Run multiple agents in isolated worktrees
 ---
 
 ## App

changelog/1.4.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.1
 date: 2026-01-02
+title: Faster terminal and multi-model comparison
 ---
 
 ## App

changelog/1.4.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.2
 date: 2026-01-02
+title: Timeline navigation with undo and redo
 ---
 
 ## App

changelog/1.4.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.3
 date: 2026-01-04
+title: Run prompts across multiple models in parallel
 ---
 
 ## App

changelog/1.4.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.4
 date: 2026-01-08
+title: Multi-project support and worktree session setup
 ---
 
 ## App

changelog/1.4.5.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.5
 date: 2026-01-08
+title: Model thinking effort and MCP toggles
 ---
 
 ## App

changelog/1.4.6.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.6
 date: 2026-01-09
+title: Answer questions right in chat
 ---
 
 ## App

changelog/1.4.7.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.7
 date: 2026-01-10
+title: Browse skills from ClawdHub
 ---
 
 ## App

changelog/1.4.8.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.8
 date: 2026-01-14
+title: Sessions sorted by most recent activity
 ---
 
 ## App

changelog/1.4.9.md

@@ -1,6 +1,7 @@
 ---
 version: 1.4.9
 date: 2026-01-14
+title: View sessions alongside files
 ---
 
 ## App

changelog/1.5.0.md

@@ -1,6 +1,7 @@
 ---
 version: 1.5.0
 date: 2026-01-16
+title: Browse workspace files in a new tab
 ---
 
 ## App

changelog/1.5.1.md

@@ -1,6 +1,7 @@
 ---
 version: 1.5.1
 date: 2026-01-16
+title: Config reload no longer crashes
 ---
 
 ## App

changelog/1.5.2.md

@@ -1,6 +1,7 @@
 ---
 version: 1.5.2
 date: 2026-01-17
+title: Start worktree sessions from branches
 ---
 
 ## App

changelog/1.5.3.md

@@ -1,6 +1,7 @@
 ---
 version: 1.5.3
 date: 2026-01-20
+title: Edit files inline in the browser
 ---
 
 ## App

changelog/1.5.4.md

@@ -1,6 +1,7 @@
 ---
 version: 1.5.4
 date: 2026-01-22
+title: Apply Patch tool shows a diff preview
 ---
 
 ## App