Feature Request: configurable scroll-off (keep N lines between cursor and viewport edge)

[dnbz]

Add a configurable vertical scroll margin — the number of lines kept between the cursor and the top/bottom edge before the pane scrolls. Same idea as vim's scrolloff or Zed's vertical_scroll_margin, exposed as a scroll-off config option (with a matching --scroll-off flag), defaulting to 0 so current behavior is unchanged.

A fixed margin of ten or fifteen lines makes reading files/plans easier.

[umputun]

the behavior is as you describe. syncViewportToCursor only scrolls when the cursor would otherwise leave the pane, so j/k at the edge parks it on the first or last row with nothing past it.

default-off is the right shape and it's how this sort of thing ships here, so no objection on form. What I'd want before wiring it is where it actually bites. You mention reading files and plans, which is the --only and full-context path rather than stepping through hunks in a diff. If that's the case, say so, it makes the argument concrete.

I'm answering this together with #311, which asks for two lines of overlap on page scroll. Different setting, same family: a configurable count of vertical context rows in the same viewport code. My reply there is #311 (comment). If both go in they get one shape between them, not two knobs arguing over where the cursor sits.