Skip to content

winTerm 1.4.2

Latest

Choose a tag to compare

@github-actions github-actions released this 25 Aug 18:13
0ee3adc

winTerm 1.4.2

winTerm 1.4.2 is a stable production release. GitHub Latest points to
v1.4.2; there is no alpha, beta, preview, or prerelease suffix in the
application, package, PowerShell module, or Release metadata.

This release contains everything changed since stable v1.3.0: the complete
Pane Search feature line, Click to position cursor, cursor-coordinate and
interaction hardening, and the associated tests and documentation.

New: Pane Search

Press Ctrl+F to search the focused pane only. Ctrl+Shift+F remains a
remappable compatibility alias. The implementation reuses the terminal's
existing search pipeline rather than maintaining a second index or buffer.

  • Search follows typing across the pane's entire active scrollback and
    highlights all matches at once.
  • Enter and Shift+Enter move forward and backward with wrap-around.
  • Case-sensitive and regular-expression modes are available from the compact
    search overlay, alongside the current / total match counter.
  • The scrollbar shows one marker per matching buffer row and emphasizes the
    current match's row. This overview is pane-local and does not require generic
    shell marks to be enabled.
  • Typing is coalesced, live results converge during sustained streaming output,
    and unchanged scrollbar state is not needlessly repainted.
  • Resize/reflow, scrollback eviction, active-buffer changes, invalid regular
    expressions, CJK, and emoji search spans have deterministic regression
    coverage.

New: Click to position cursor

A plain single left click inside the current editable command moves the shell
cursor to that location. winTerm calculates the cell distance and sends LEFT
or RIGHT input events, keeping PowerShell, Readline, and cooked-input state
authoritative. It never moves only the renderer cursor, edits the command
buffer directly, inserts or deletes text, or executes the command.

The feature is enabled by default for winTerm profiles. It can be disabled in
Profile > Advanced > Click to position cursor, and an explicit existing
"experimental.repositionCursorWithMouse": false setting remains respected.
The internal JSON property name is retained for configuration compatibility;
the user-facing feature is not described as experimental.

Shell integration supplies the safety boundary. Positioning is allowed only
when the last shell mark identifies a current, unfinished editable command.
Clicks on previous commands, previous output, unrelated scrollback, completed
or executing commands, and any position that cannot be validated are safe
no-ops.

Mouse behavior and compatibility

Cursor positioning occurs on left-button release only when the existing drag
threshold was not crossed. Starting a drag never moves the command cursor
first. Existing interaction precedence remains:

  1. Ctrl+Click hyperlink activation.
  2. VT mouse reporting to the child terminal application.
  3. Double-click word and triple-click line selection.
  4. Shift+Click and drag selection.
  5. Plain single click positioning.

Mouse-aware applications such as Vim, Less, top, htop, k9s, and tmux retain
mouse ownership when VT mouse reporting is active. Each split pane owns its
own terminal connection, marks, selection state, and cursor-position input.

Stability fixes

  • Integrated the safety intent of Microsoft Terminal PR #20442, merged as
    de3fc87d186e5da1d5ccd8731412905f5e2aba30. Mouse coordinates are translated
    at widened precision, vertical padding and out-of-viewport rows are rejected,
    horizontal padding is clamped to rendered buffer cells, and every point is
    checked against the TextBuffer's inclusive coordinate contract before use.
  • Negative, overflow, beyond-width, beyond-height, padding, empty-command,
    historical-output, wrapped-command, resize-era, and pane-isolation cases
    fail safely and have automated regression coverage.
  • Full-width glyph trailing cells do not produce duplicate LEFT/RIGHT events.
  • Pane Search reflow no longer creates a stray selection, active-buffer changes
    discard stale highlights, and closing search releases retained search-span
    storage.

Downloads

  • winTerm-1.4.2-setup-x64.exe — current-user or all-users installation.
  • winTerm-1.4.2-portable-x64.zip — extract and run without installation;
    portable.marker keeps data beside the executable.
  • SHA256SUMS.txt — checksums for the application downloads and published
    release artifacts.
  • THIRD_PARTY_NOTICES.md — dependency and attribution notices.
  • SBOM.spdx.json and SBOM.cyclonedx.json — software bills of materials.
  • release-metadata.json — immutable build and source provenance.
  • winTerm-1.4.2-release-notes.md — the packaged copy of these notes.

Upgrading keeps settings, themes, workspaces, and snapshots under
%LOCALAPPDATA%\winTerm, or under the adjacent data directory in portable
mode.

Signing

The installer is not Authenticode-signed. Windows may display Unknown
Publisher or a Microsoft Defender SmartScreen warning. Download only from the
official GitHub Release and verify SHA256SUMS.txt from that same Release
before running the installer.

Requires Windows 11 x64. winTerm is an independent open-source project based
on Microsoft Terminal source code; it is not a Microsoft product and is not
affiliated with or endorsed by Microsoft.

Policies