# Whinge changelog

## 0.2.0 — Just the recording

- Whinge now records, and that's all it does. When you stop, you get a folder with the recording
  of each display, your voice, a live transcript, the screenshots you drew on, and a timeline of
  everything that happened. It no longer reads a `WHINGE.md`, runs Claude, or makes tasks and
  panels afterwards, so you can take the recording wherever you like.
- What you say is transcribed on your Mac as you say it, rather than once you've stopped.
- Choose which microphone Whinge listens to, and try speech recognition out, in the new
  Settings → Speech.
- `whinge start` stays for the whole recording and prints what's happening as it happens, one JSON
  line at a time, finishing with the folder. `--wait`, `--print` and `--context` are gone.
- Whinge checks its permissions when it opens and walks you through turning them on. **Allow…**
  opens the right page of System Settings with a panel to drag this copy of Whinge into, and
  macOS's screen recording confirmation comes up while you're setting up rather than in the
  middle of your first whinge.
- Settings is quicker to move around, and its windows open in front of what you're doing, in the
  middle of the screen.
- While you're drawing, the mouse wheel scrolls the page underneath, except in the middle of a
  stroke, where it changes the size of the pen.

## 0.1.6 — The version it says it is

- `whinge version` now tells you the truth. It had printed `0.1.0` since the day the command was
  written, whatever you had installed, which made a perfectly good update look like it hadn't
  taken. It reads the version out of the app it came from, so the two can't drift apart again —
  including after Whinge has updated itself underneath the command.
- `whinge --version`, `whinge --help` and `whinge -h` work. They used to be turned away as if you
  had mistyped a whinge.

## 0.1.5 — Updates and bug reports

- Whinge now updates itself. When there's a new version it says so with a notification and an
  **Update to…** item in the menu, and it never restarts in the middle of a whinge. Turn on
  automatic installs, or check by hand, in Settings → General. This is the last version you need
  to install yourself.
- Report a problem with Whinge the way you whinge about anything else: press the ladybird on the
  toolbar (or choose **Report a Bug in Whinge…** from the menu), say and draw what's wrong, and look
  it all over before anything is sent. During a whinge, the whinge pauses while you do.
- A crash no longer loses your whinge. What you say is transcribed as you go, the recording is
  saved every few seconds, and next time Whinge opens it offers to write up what was saved.
- While Whinge is listening for “let's whinge”, its toolbar shows what it's hearing, so you can
  tell whether the microphone and speech recognition are working.
- Whinge keeps a debug log of what it's doing, on your Mac: **Show Debug Log** in the menu, or
  `whinge log`. It's only sent if you include it in a bug report.

## 0.1.4 — Permissions

- When Screen Recording is switched on for Whinge but still refused, which happens after a copy
  of Whinge with a different signature was installed over another, Whinge now says what to do:
  switch it off and on again.
- Building from source gives a separate app, Whinge Dev, that installs beside the release with
  its own permissions, settings and `whinge-dev` command, so a development build no longer
  disturbs the one you use.

## 0.1.3 — Panels

- Watch what happens after you stop: each whinge gets a window listing its tasks (transcribing,
  topics, screenshots, the plain draft, then your `WHINGE.md`), with Claude's output a click away.
  The menu bar lists every whinge being processed.
- Record the next whinge straight away: processing carries on in the background, several at once.
- See what Claude makes as it makes it: it adds each issue or file to the window with
  `whinge task`, with a link to open.
- Split a `WHINGE.md` into `tasks:`, each a part of the brief for Claude or a command to run,
  waiting on the ones it `needs`.
- Stop a run, or try again without redoing what finished: **Try again** in the window, or
  `whinge process DIR --failed`.
- `whinge --wait`, `--print` and `whinge process` now exit 1 when a task didn't finish.
- Keep the desktop out of your whinges with the privacy screen: its icons are covered while one is
  on. Have it swap the wallpaper for a colour or a picture, or hide every other app, in Settings →
  General. Your Mac's settings are left alone.
- Find a whinge's window again: Whinge is in the Dock and ⌘Tab while one of its windows is open.
- A new icon: a hand-drawn speech bubble with a squiggle in it, in the Dock, in Finder and in the
  menu bar.
- Ink sticks to what it's drawn on: drag a window and your drawing follows it, and put a window in
  front and the drawing is hidden behind it. In a browser each tab keeps its own drawing, there
  again when you switch back. A screenshot of each one is kept for the write-up before you move on.
- Rub out one stroke without clearing the lot: pick the eraser (or press E while drawing) and drag
  over it. ⌘Z brings it back. The clear button is now a bin.
- Ink drawn on a page follows it as you scroll, in Safari and Chrome, and is cut off at the edge
  of the page rather than drawn over the browser. It needs Accessibility permission; without it,
  ink stays where the window is.
- Typing goes to your app again once you turn drawing off. Before, what you typed went to Whinge
  instead, and a stray Return cleared the ink.
- Hide other apps in the privacy screen now brings them back when the whinge ends.

- Keep a checklist, a queue or any small HTML app beside your work: `whinge panel open DIR` shows
  it in a floating window that doesn't take focus and can be drawn on.
- Follow along from Claude Code: everything that happens in a panel is printed as JSON lines, and
  `whinge panel send` hands it new data.
- Give a panel live data safely: it can only load its own files, and the tools its `panel.json`
  declares run in the process that opened it. Panels talk to Whinge like MCP Apps do.
- Tick things off mid-whinge: panel events are noted under the topic they happened in, and a
  panel can clear the drawing to start the next topic.
- Follow a brief kept anywhere with `whinge --brief FILE`.
- Start one with `whinge panel init`, and read how they work at whinge.computer/docs/panels or with
  `whinge panel docs`. `/whinge` tells Claude Code where to look.
- Put a header behind the window's close button with `"titlebar": "overlay"`.
- Swap the toolbar for a wheel that opens at the pointer: hold its shortcut, flick towards a tool
  or colour and let go, or tap it and click. Choose it in Settings → Toolbar.
- Keep the bar out of the way until you want it, and call it to the pointer with ⌃⌥T.
- Open the toolbar with a spare mouse button, like back or forward. It needs Accessibility
  permission, and the button goes back to its usual job when the whinge ends.

## 0.1.2 — Live output

- Watch the write-up happen: `whinge process DIR --print` and `whinge start --wait` now print
  Claude's text and tool calls as they arrive, rather than nothing until it's finished.
- Keep the whole run in `claude-stream.jsonl` in the session folder, to read back afterwards.
- Say which signal killed a run that was interrupted, instead of a bare exit code.

## 0.1.1 — Diagnostics

- Install from a signed disk image: open the download and drag Whinge into Applications.

- Opt in to sharing crash and failure diagnostics in Settings → General.
- Report a problem from the menu bar or Settings, with a preview of exactly what will be sent.
- Include app/macOS versions, failure categories, numeric error codes and crash stack addresses. Reports exclude recordings, screenshots, transcripts, prompts, project paths and account details.
- Retry automatic reports when the connection returns; crash reports are collected when Whinge next runs.

## 0.1.0 — First release

The first downloadable release of Whinge for macOS 26 and later.

### Talk and draw

- Record every display and your microphone while you talk through feedback.
- Draw on your screen with a floating marker toolbar, configurable colours and sizes, and undo.
- Clear a drawing to start the next topic and capture a screenshot with your annotations still visible.
- Toggle drawing with Control–Option–D, leaving the mouse free to use your apps between annotations.

### Start when you’re ready

- Open Whinge from the menu bar, the terminal, or the /whinge command in Claude Code.
- Say “let’s whinge” or “it’s whinging time” to begin recording, or press the toolbar’s record button.
- Check your microphone with the live meter before recording starts. A chime and timer confirm you’re recording.
- Use whinge:// links with launchers, pedals, or Stream Decks to start, toggle, draw, and clear.

### Turn feedback into useful work

- Transcribe speech on your Mac with on-device speech recognition.
- Split feedback into topics and match each one with screenshots cropped to the relevant window.
- Give each project a WHINGE.md that tells Claude Code what to do: write a document, create GitHub issues, or follow your own workflow.
- Choose the model and allowed tools in WHINGE.md, and use whinge init to create a starter brief.
- Keep a default brief for sessions started from the menu bar, editable in Settings.
- Save a plain draft before running Claude Code, keep its response with the session, and retry processing with whinge process.

### Make it your own

- Configure launch at login, the session folder, drawing shortcut, markers, speech language, permissions, and command-line integration in Settings.
- Keep recordings, transcripts, annotated screenshots, and the final write-up together in each session folder.
- Install the bundled whinge CLI and Claude Code slash command for feedback without leaving your project.

### Early fixes

- Corrected transcript timing for the first spoken words.
- Kept the floating toolbar out of recordings and removed duplicated window labels.

### Website and downloads

- Added the Whinge website with a macOS download button and release notes.
- Added independent app and changelog publishing, so updates don’t require a new website deployment.