[saddlepaddle]

Summary

• On mobile, the terminal's scroll-to-bottom button now works when Claude Code is in fullscreen mode. It appears while Claude is scrolled up, and tapping it jumps Claude back to the bottom.
• Plain terminal scrollback is unchanged. So is the button's position (bottom-center, as since feat(mobile): add a scroll-to-bottom button to the terminal #6844).

Recording + screenshots: https://app.superset.sh/page/claude-scroll-to-bottom-on-mobile-czhn1y

Why / Context

Claude's fullscreen mode ("tui": "fullscreen" / CLAUDE_CODE_NO_FLICKER=1) draws its transcript in the alternate buffer and scrolls it itself. xterm keeps no scrollback there, so the page always reported atBottom: true: the button never showed, and term.scrollToBottom() did nothing. The only way back down on a phone was Claude's own pill.

How It Works

• Claude exposes no scroll position; I checked the 2.1.276 binary for escape sequences, hooks and status fields. The only signal is the pill it centers above the prompt while scrolled up, which reads Jump to bottom or N new messages, optionally followed by (click) ↓, (key) ↓ or : key to scroll.
• In the alternate buffer, updateScrollbar treats that pill as "not at bottom". A match must be the pill text and centered on its row (±1 column), so the same words inside the transcript don't count.
• scrollToBottom in the alternate buffer sends ctrl+End (\x1b[1;5F). That is Claude's scroll:bottom binding in its fullscreen Scroll context, and it works while a draft sits in the prompt. It only sends while the pill is on screen, so vim, less and other full-screen apps never receive it.

Manual QA Checklist

• iPhone 17 Pro Max sim on prod, real Claude session (2.1.276, fullscreen) in a terminal on a Mac host: a swipe scrolls Claude up → pill + ↓ button appear → tap → Claude is back at the bottom, and the pill and button disappear (video on the page above)
• Plain shell with 300 lines: the button appears when scrolled up in the same bottom-center spot, and a tap returns to the end
• Ctrl+End with a draft in Claude's prompt scrolls Claude down and keeps the draft (tmux)

Testing

• Headless harness (not committed) running the real generated page against Claude's own output bytes recorded at phone width (46 columns): 10/10 pass. It covers: pill → not-at-bottom; the button sends Ctrl+End once; Claude's redraw → at-bottom; uncentered pill text in the transcript is ignored; no pill → nothing sent; normal-buffer scroll and scrollToBottom unchanged.
• bunx biome check apps/mobile/scripts/generate-terminal-html.ts
• Typecheck not run locally: the change is inside the page's JS string. CI runs it.

Known Limitations

• This depends on the wording and centering of Claude's pill. If Claude changes either, the button quietly stops appearing in fullscreen mode (today's behavior). Nothing else breaks.

---

Summary by cubic

Fixes the mobile terminal's scroll-to-bottom button in Claude Code's fullscreen mode, where it previously never appeared and tapping did nothing. The button now appears when Claude's "Jump to bottom" pill is on screen, and tapping it sends Ctrl+End to scroll Claude back to the bottom. Normal terminal scrollback and the button's bottom-center position are unchanged.

^{Written for commit 58a8448. Summary will update on new commits.}

Summary by CodeRabbit

• Bug Fixes
  • Improved terminal scrolling in Claude Code’s fullscreen mode.
  • The scroll-to-bottom control now correctly reflects the terminal’s position and uses the appropriate navigation behavior when the jump indicator is shown.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: ee281c3a-6546-4086-b711-55896333209b

📥 Commits

Reviewing files that changed from the base of the PR and between b6b4c59 and 58a8448.

⛔ Files ignored due to path filters (1)

• apps/mobile/screens/(authenticated)/workspace/[id]/components/TerminalWebView/terminalHtml.generated.ts is excluded by !**/*.generated.*

📒 Files selected for processing (1)

• apps/mobile/scripts/generate-terminal-html.ts

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

---

📝 Walkthrough

Walkthrough

The terminal WebView now separates normal-buffer scrolling from Claude Code alternate-screen scrolling. It sends Claude's scroll key sequence when the jump pill is visible and derives alternate-buffer bottom state from the pill.

Changes

Terminal scroll handling

Layer / File(s)	Summary
Alternate-screen scroll behavior apps/mobile/scripts/generate-terminal-html.ts	Normal buffers use term.scrollToBottom(). Claude alternate-screen buffers send \x1b[1;5F when the jump pill is visible. The scrollbar derives atBottom from the centered, single-line Claude jump pill.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the primary change and follows the required conventional commit format: fix(mobile): scroll-to-bottom button drives Claude Code’s fullscreen view.
Description check	✅ Passed	The description explains the problem, implementation, testing, manual QA, and limitations. It is mostly complete, although it does not use the exact template headings and omits the repository checklis…
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[expo]

No installed development build can load this pull request as an update: its native fingerprint is c68b78a2cc25 and no development build has it. Add the mobile-build label to build one.

[github-actions]

🧹 Preview Cleanup Complete

The following preview resources have been cleaned up:

• ✅ Neon database branch

Thank you for your contribution! 🎉