Skip to content

winTerm 1.3.0-beta3

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 05 Aug 14:01

winTerm 1.3.0-beta3

This is a beta prerelease. The current stable release remains
v1.2.0, and
/releases/latest continues to point there. The beta is listed on the winTerm
website next to the stable download and is published as a GitHub prerelease;
it is not submitted to WinGet.

winTerm 1.3.0-beta3 is the third beta of the Command Timeline release.
It fixes one Visual Progress defect reported from beta2 field testing and is
otherwise identical to beta2.

Fixed since 1.3.0-beta2

  • Long-running commands no longer animate the progress bar forever. Any
    command without a real progress source used to keep the Visual Progress
    rainbow animation looping until it exited — effectively forever for
    Alternate Screen applications (k9s, vim, top, htop), development servers
    (FastAPI/uvicorn, Spring Boot, Node.js), tail -f, and
    kubectl port-forward. The OSC 133 launch fallback is now a bounded
    one-shot launch indication: the comet makes one traversal, then the overlay
    disappears and releases its animation resources while the command keeps
    printing output normally. Entering or leaving the Alternate Screen,
    resizing, or switching tabs does not replay it, and the eventual real
    result still shows the normal success, error, or cancelled presentation.
    Explicit OSC 9;4 progress, recognized CLI providers (Docker, pip, Git,
    curl, wget, npm/pnpm/yarn, nvm, Maven, Gradle), and short-lived commands
    keep their existing behavior, and no command-name or process-name matching
    is involved. Screen readers hear neither a fake completion nor a fake
    cancellation when the launch indication ends.

What is new since v1.2.0: Command Timeline

The Command Timeline is a per-pane, in-memory list of the commands that pane
has run. Open it with Ctrl+Tab, or with the thin auto-hiding handle on the
left edge of the terminal; click the terminal, press Escape, or press
Ctrl+Tab again to close it.

  • Per-pane history. Each pane keeps its own list, built from OSC 133
    shell integration only. winTerm never guesses where a prompt or output
    begins, and cmd.exe — which does not report command boundaries — shows
    Command timeline unavailable rather than untrustworthy results.
  • Works out of the box. A profile whose commandline is a bare
    powershell.exe or pwsh.exe (optionally with -NoLogo/-NoExit)
    automatically imports the packaged winTerm.Shell integration module at
    startup. Any customized commandline launches unchanged; the per-profile
    setting "shellIntegration.autoInject": false turns the rewrite off.
  • Load without executing. Enter or a single click puts the selected
    command on the input line and stops there. No carriage return is ever sent,
    the Windows clipboard is never read, and input broadcast never forwards the
    load to another pane.
  • Filtering. Press / or Tab and type to narrow the list. Matching is
    a plain, case-insensitive substring match over command text only — no
    wildcards, no regular expressions, no fuzzy matching, and command output is
    never searched.
  • Copy and jump. Right-click an entry to copy the command, copy its
    output, or scroll to where its output begins. Output is read from the
    terminal buffer only at that moment and is never cached.
  • Trustworthy status. A command shows ● Running while it executes and
    resolves to ✓ Succeeded or ✕ Failed when the shell reports its exit code.
    Unknown appears only when the shell genuinely did not report a result,
    and explains itself on hover. Status is never conveyed by color alone.
  • Readable rows. Hover any row for the full command text; the selection
    moves without rebuilding rows, so the list stays steady under the arrow
    keys.

Keyboard

Shortcut Behavior
Ctrl+Tab Toggle the Command Timeline for the focused pane
Ctrl+T Next tab
Ctrl+Shift+T Previous tab
Ctrl+Alt+T Open new tab

While the Timeline is open:

Key Behavior
/ or Tab Move focus to the filter box
Up / Down Move the selection by one command
Left / Right Select the first / last command on the current page
Enter Load the selected command; never runs it
Space Scroll the terminal to that command's output
Ctrl+C Copy the selected command text
Escape Clear the filter, or close the Timeline if the filter is empty

Your own key bindings take precedence over every default above. Keys the
Timeline consumes are not sent to the shell, and filter text never reaches
the shell.

Settings

{
  "commandTimeline.enabled": true,
  "commandTimeline.historyLimit": 500
}

Per profile:

{
  "shellIntegration.autoInject": true
}
  • Show command timeline defaults on. Turning it off hides the handle,
    closes an open overlay, and stops Ctrl+Tab from opening it.
  • Commands remembered per pane defaults to 500 and accepts 50 through
    5000. An out-of-range value is clamped rather than failing the settings
    load.

An existing settings file needs no migration. Visual Progress settings are
unchanged; the bounded launch behavior needs no new setting.

Changes accumulated through the prerelease series

  • alpha2: auto-injected shell integration, the auto-hiding handle,
    terminal-click light dismiss, and the recognition-engine fixes for stuck
    progress bars.
  • alpha3: correct FinalTerm mark emission (no stray characters, exact command
    capture), no progress bar at an idle prompt, no phantom Timeline row, no
    selection jitter, and silent degradation when antivirus blocks an optional
    module component.
  • alpha4: the antivirus write-then-execute false positive removed at its
    source, ✓/✕ results restored through the Enter-keypress lifecycle
    notification, and full-command tooltips.
  • beta2: real exit codes restored to the finished mark, so failures resolve
    to ✕ Failed instead of a false ✓ Succeeded.
  • beta3: the Shell Integration launch fallback is a bounded one-shot, so
    long-running commands no longer animate the progress bar forever.

Privacy

  • Command text lives only in memory, only in the pane that ran it, and only
    while that pane is open. Nothing is written to disk; there is no command
    history file or database.
  • Command output is never cached, indexed, or searched.
  • Filter text is never saved and never leaves the pane.
  • No telemetry is written, and no command, output, path, or filter text is
    logged.
  • The clipboard is written only by an explicit copy action, and is never
    read.

See the privacy policy.

Unchanged in this release

Workspace schema (2), docking model (1), shell protocol (1), theme schema
(1), update manifest schema (1), package identity, and signing policy are all
unchanged from v1.2.0. Visual Progress keeps its v1.2.0 semantics for
explicit progress, recognized providers, determinate values, and the
success/error/cancelled presentations; only the generic launch fallback is
now bounded as described above.

Known limitations

  • The Timeline requires OSC 133 shell integration; it stays unavailable under
    cmd.exe.
  • A multi-line command is refused when the shell has not enabled bracketed
    paste, because unbracketed line breaks would be read as pressing Enter.
  • Loading a command longer than 1024 characters asks for a confirming
    Enter.
  • Command history does not survive closing a pane, and is intentionally never
    persisted.

Installation

The Setup EXE supports current-user and all-users installation; the Portable
ZIP can be extracted to a writable directory and run without installation.
Installing the beta over v1.2.0 or an earlier prerelease is supported; the
file version is 1.3.0.6. Package identity stays separate from Microsoft
Terminal, so it does not disturb an existing Windows Terminal installation.

Publisher: helloThisWorld. Tag: v1.3.0-beta3.

Signing

The winTerm 1.3.0-beta3 Setup EXE is not Authenticode-signed. Windows may
display Unknown Publisher or a SmartScreen warning. Download only from the
official GitHub Release and verify the file against SHA256SUMS.txt before
running it.

Policies