Latest release

Release Notes — Zync v2.22.1

Release date: 2026-07-14

---

What's New

Zync v2.22.1 is a terminal ghost suggestions patch release. It fixes inline completions that looked wrong while typing — especially on SSH — without changing host catalog or sync behavior from 2.22.0.

Highlights:

• History mid-command completions no longer invent a space (ls + history lsblk → lsblk, not ls blk)
• Ghost text no longer stacks under delayed remote echo on SSH
• Overlay glyphs align better with terminal cells (display width, combining marks, emoji)
• Path suggest no longer treats cd cd as a bare cd (wrong leading space on directory completions)

Compare: https://github.com/zync-sh/zync/compare/v2.22.0...v2.22.1

---

Fixed

• Ghost mid-token spacing — History completions no longer invent a leading space. Typing ls with history lsblk ghosts as blk (→ lsblk), not ls blk. Normalize passes provider suffixes through; path suggest owns spaces for bare cd path args; ranking prefers true mid-token matches over spaced new-word entries (including when a bad spaced history entry was accepted earlier). (34192d9)
• Ghost SSH echo lag — Inline ghost positions from the line origin plus typed display cells when the caret lags remote echo, so faded text does not paint under keystrokes that have not echoed yet. (34192d9)
• Ghost overlay cell metrics — Overlay segments use terminal display width (wide CJK/emoji, combining marks) and measured xterm cell size; wrap prediction clamps to the viewport bottom row. (34192d9)
• Path bare-command false positive — cd cd (argument equal to the command name) is no longer treated as bare cd. Partial stays cd and completions do not inject a leading space. Same for pushd / popd. (64fb421)
• Overlay combining marks / emoji width — Zero-width combining marks merge into the previous base glyph (no invisible width: 0 spans). ZWJ and skin-tone emoji clusters use grapheme-aware cell width (typically 2 cells, not summed parts). (64fb421)

---

Changed

• Ghost spacing ownership — Frontend no longer rewrites suggestion suffixes. Backend ranking and normalize own mid-token vs new-word boundaries. (34192d9)
• Mid-token ranking constant — History mid-token score boost is a named constant for clearer maintenance. (64fb421)

---

Quick check after upgrade

1. History mid-token — Run lsblk once, then type ls. Ghost should complete as lsblk (no space between ls and blk).
2. SSH lag — On a remote shell, type quickly; ghost should sit after the typed characters, not under them.
3. Accept — Right-arrow accept still injects the suffix and leaves a correct command line.
4. Path / args — Bare cd + directory suggestions keep a space before a new path. Typing cd cd does not force a bare-command space prefix.
5. Unicode (optional) — Ghost overlay still aligns for simple combining characters (e.g. accented letters) and wide glyphs.

---

Upgrade

Zync will update automatically on next launch.

Manual install: Releases — v2.22.1

# Debian / Ubuntu (APT repository)
sudo apt update && sudo apt install zync

---

Full Changelog

See CHANGELOG.md for complete technical details.

---

Commit References