docs: add Pi todowrite UX to v0.31.3 notes

Co-authored-by: Alfonso [Magic Context] <288211368+alfonso-magic-context@users.noreply.github.com>

Author: ualtinok

.alfonso/release-notes/v0.31.3.md

@@ -8,6 +8,14 @@ v0.31.2 restored the OpenTUI runtime dependencies so the sidebar loads again, bu
 
 The TUI is now precompiled at publish time and binds directly to the host's OpenTUI runtime, so the sidebar is fully live from npm installs. Older OpenCode versions and development checkouts keep working through an automatic fallback. The release pipeline now installs the packed artifact and verifies the compiled output before publishing, so this failure class is gated structurally.
 
+## Pi: todowrite gets real UX and a disable switch
+
+Magic Context registers a `todowrite` tool on Pi (Pi has no built-in task list). It previously rendered raw JSON and could not be turned off, which clashed with community todo extensions. Now:
+
+- A persistent todo overlay above the editor shows active tasks with status glyphs and counts while work is in flight, and hides itself when the list empties. It survives restarts.
+- Tool calls render as compact status lines instead of JSON dumps, and a `/todos` command lists tasks grouped by status.
+- New `todowrite.enabled` config (default `true`): set to `false` if you use your own todo extension, and Magic Context registers neither the tool, the command, nor the overlay. `todowrite.overlay` controls just the widget.
+
 ## Pi fixes
 
 - Commands and tools now follow `/cd`: `/ctx-status`, `/ctx-dream`, `/ctx-wrapup`, `/ctx-embed`, smart notes, and the rest resolve the active project's configuration at invocation time instead of using the project Pi was launched in.