Skip to content

[Feature]: Configurable terminal scroll sensitivity (expose xterm.js scrollSensitivity) #3431

Description

@StasKhitrich

Feature description

Problem. On macOS with a trackpad, terminal scrolling in Wave feels significantly less sensitive than in native terminals (iTerm2/Terminal.app). Long Claude Code / TUI sessions require a lot of finger-dragging to move through scrollback.

Cause. xterm.js supports scrollSensitivity and fastScrollSensitivity options (defaults: 1 and 5), but Wave doesn't expose them — frontend/app/view/term/term.tsx only passes scrollback into terminal options, so users are stuck with the default sensitivity. (Alt+wheel fast-scroll also doesn't seem to kick in on macOS trackpads.)

Environment. Wave 0.14.5, macOS (Darwin 25), trackpad.

Implementation Suggestion

Add two settings keys, passed through to xterm.js options:

  • term:scrollsensitivity (float, default 1)
  • term:fastscrollsensitivity (float, default 5)

Both fit the existing term:* config pattern and are a small change in term.tsx where terminal options are built.

Anything else?

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesttriageNeeds triage

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions