winTerm 1.3.0-beta3
Pre-releasewinTerm 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, andcmd.exe— which does not report command boundaries — shows
Command timeline unavailablerather than untrustworthy results. - Works out of the box. A profile whose commandline is a bare
powershell.exeorpwsh.exe(optionally with-NoLogo/-NoExit)
automatically imports the packagedwinTerm.Shellintegration module at
startup. Any customized commandline launches unchanged; the per-profile
setting"shellIntegration.autoInject": falseturns the rewrite off. - Load without executing.
Enteror 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
/orTaband 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.
Unknownappears 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 stopsCtrl+Tabfrom 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.