Skip to content

fix: mobile touch scroll + DPad scroll mode + mode toggle#95

Open
k3nnethfrancis wants to merge 1 commit intogbasin:masterfrom
k3nnethfrancis:feat/mobile-scroll-and-controls
Open

fix: mobile touch scroll + DPad scroll mode + mode toggle#95
k3nnethfrancis wants to merge 1 commit intogbasin:masterfrom
k3nnethfrancis:feat/mobile-scroll-and-controls

Conversation

@k3nnethfrancis
Copy link

Summary

  • Fix: tmux mouse mode set globally (-g) instead of per-session so grouped sessions (agentboard-ws-*) inherit it — fixes broken touch scrolling on mobile
  • Replace NumPad with mode toggle button: sends Shift+Tab for Claude Code auto-accept/plan mode toggle
  • Add scroll mode to DPad: tap to toggle between cursor/scroll, long-press for joystick

Files Changed

  • src/server/SessionManager.ts — global mouse mode fix
  • src/server/__tests__/sessionManager.test.ts — updated assertions
  • src/client/components/DPad.tsx — dual-mode (cursor/scroll) with tap toggle
  • src/client/components/Terminal.tsx — added handleSendScroll callback
  • src/client/components/TerminalControls.tsx — replaced NumPad with mode toggle, threaded scroll prop
  • src/client/__tests__/terminalControls.test.tsx — updated for NumPad removal
  • start-agentboard.sh — launch script for launchd auto-start

Test Plan

  • Verify touch scrolling works on mobile (iOS Safari)
  • Verify DPad cursor mode works (arrow key navigation)
  • Verify DPad scroll mode works (tap to toggle, sends scroll events)
  • Verify long-press joystick still works in both modes
  • Verify mode toggle button sends Shift+Tab
  • Verify existing keyboard/mouse interaction unaffected on desktop

Touch scrolling was broken on all tmux terminals because mouse mode
was set per-session but grouped sessions (agentboard-ws-*) inherited
the global setting (mouse off). Changed to set-option -g so all
sessions get mouse mode.

Replaced NumPad "123" with a mode toggle button that sends Shift+Tab
to toggle Claude Code auto-accept/plan mode from mobile.

Added dual-mode DPad: tap toggles between cursor mode (arrow keys)
and scroll mode (tmux scroll via SGR mouse sequences). Visual
indicator changes to accent color in scroll mode.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant