release: v0.4.0b3

Peek UX improvements: scrollbar, thinking traces, full text/tool args,
context token display, persistent Shift+P hint, clearer page nav labels.
Fix HTML comments in code blocks breaking prompt assembly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to ralphify are documented here.
 
+## 0.4.0b3 — 2026-04-12
+
+### Improved
+
+- **Full-screen peek scrollbar** — a scrollbar on the right edge of the full-screen peek view shows your position in the activity log, so you always know where you are in a long session.
+- **Thinking traces visible** — agent reasoning (thinking blocks) now appears in the activity feed as dim italic text instead of being silently dropped. Long thinking traces are split by newline so you can scroll through the full reasoning.
+- **Full text and tool args** — assistant text output is no longer truncated to 100 characters, and tool parameters for Agent and ToolSearch now show their actual values (description, prompt, query, max_results) instead of just listing parameter names.
+- **Context token display** — token counts in the panel title now show as `ctx 156k · out 3.2k` instead of `↑156k ↓3.2k`, making context window usage immediately clear.
+- **Persistent Shift+P hint** — the compact panel footer now always shows "Shift+P full screen" so new users discover full-screen peek without reading docs.
+- **Clearer page navigation labels** — the full-screen footer now says `b page up · space page down` instead of the ambiguous `b/space page`.
+
+### Fixed
+
+- **HTML comments in code blocks** — `<!-- -->` comments inside fenced code blocks in RALPH.md files no longer break prompt assembly.
+
+---
+
 ## 0.4.0b2 — 2026-04-12
 
 ### Added

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ralphify"
-version = "0.4.0b2"
+version = "0.4.0b3"
 description = "Stop stressing over not having an agent running. Ralph is always running"
 readme = "README.md"
 license = "MIT"

src/ralphify/_console_emitter.py

@@ -361,18 +361,15 @@ def _apply_assistant(self, raw: dict[str, Any]) -> None:
                 text = block.get("thinking", "")
                 if text:
                     for tline in text.split("\n"):
-                        self.add_scroll_line(
-                            f"[dim italic]{escape_markup(tline)}[/]"
-                        )
+                        self.add_scroll_line(f"[dim italic]{escape_markup(tline)}[/]")
 
             elif block_type == "text":
                 text = block.get("text", "")
                 if text:
                     for tline in text.split("\n"):
                         if tline.strip():
                             self.add_scroll_line(
-                                f"[italic {_brand.LAVENDER}]"
-                                f"\"{escape_markup(tline)}\"[/]"
+                                f'[italic {_brand.LAVENDER}]"{escape_markup(tline)}"[/]'
                             )
 
             elif block_type == "tool_use":
@@ -403,9 +400,7 @@ def _apply_assistant(self, raw: dict[str, Any]) -> None:
                         f"[dim]{escape_markup(arg)}[/]"
                     )
                 else:
-                    self.add_scroll_line(
-                        f"[bold {color}]{escape_markup(name)}[/]"
-                    )
+                    self.add_scroll_line(f"[bold {color}]{escape_markup(name)}[/]")
 
     def _apply_user(self, raw: dict[str, Any]) -> None:
         msg = raw.get("message", {})

tests/test_console_emitter.py

@@ -1370,9 +1370,7 @@ def test_apply_tool_use_updates_counters(self):
 
     def test_apply_system_init_sets_model(self):
         panel = _IterationPanel()
-        panel.apply(
-            {"type": "system", "subtype": "init", "model": "claude-opus-4-6"}
-        )
+        panel.apply({"type": "system", "subtype": "init", "model": "claude-opus-4-6"})
         assert panel._model == "claude-opus-4-6"
 
     def test_apply_usage_updates_tokens(self):