Track progress toward a fully functional tmux clone. Based on code audit as of 2026-06-21.
advanceBatch, fast-path ASCII streaming in writeStr, O(1) pane validity tracking isPaneValid, batched SGR and render output, arena format string allocations). Configurable Unicode VS16 emoji presentation width option (variation-selector-always-wide). Hardened Sixel graphics subsystem (containment verification, scroll-region bound anchor shifting, surviving marker cell purging, transactional placement error rollback). Stable display client pointer lifetimes (ArrayList(*DisplayClient)), bounded OSC 52 clipboard and IPC frame limits, race-free PTY child reaping before SIGKILL, Kitty extended keyboard release filtering, raw terminal diagnostics, a 70-bug stability sweep (#441–#510), and the #511–#562 audit sweeps.Thai & Lao text rendering & reflow correctness sweep (#502–#505, SARA AM diff-cache cluster repair): compound-vowel cluster integrity (เ-าะ patterns no longer split at reflow boundaries), atomic state transitions for runtime libthai loading in src/thai.zig, and two-way SARA AM diff repair (Display.renderContent pre-pass covering Thai U+0E33 and Lao U+0EB3 with deduplicated resolveCell and isolated thai.isSaraAm).
Dual-toolchain support (2026-10-05): szn now compiles on both Zig 0.16.0
and 0.17.0 from one source tree. Zig 0.17 removed or renamed a number of std
APIs; each was replaced with a spelling that exists in both releases
(bufPrintSentinel, meta.fieldNames, mem.zeroes, allocSentinel,
ascii.eqlIgnoreCase, = .empty), and the two cases with no shared form
(Allocator.dupeZ, std.ascii.indexOfIgnoreCase) plus the optimize-tag check
were routed through a new src/compat.zig. The only comptime version branches
are two @hasField gates in build.zig (Build.build_root, .Debug tag).
zig build test passes 1082/1082 on 0.16.0 and on 0.17.0 (re-verified 2026-10-30 with -Doptimize=ReleaseFast on a clean cache, after the #562 fix: a test use-after-free that only Zig 0.17’s non-reusing SafeAllocator exposed).
| Phase | Description | Status | Tests | Notes |
|---|---|---|---|---|
| 0 | Scaffolding + Test Harness | ✅ Done | — | build.zig, test.zig, log.zig (err.zig was removed — see bug #36) |
| 1 | Grid + Colour + Screen | ✅ Done | ~90 | Cell, Grid, Screen, Colour all complete |
| 2 | Key + Session + Window + Layout | ✅ Done | ~40 | Key parse/format, Session, Window, Pane, Layout tree |
| 3 | Options + Config | ✅ Done | ~25 | Options store, config parser (set, bind, source, if-shell) |
| 4 | TTY Output Engine | ✅ Done | ~35 | Term writer, cursor, SGR, clearing, scroll region, alt screen |
| 5 | TTY Input Parsing | ✅ Done | ~25 | InputReader: keys, mouse, UTF-8, focus, paste, kitty |
| 6 | Input Escape Parser | ✅ Done | ~80 | CSI, OSC, DCS, DECSET, SGR, scroll regions, alt screen |
| 7 | Format + Status | ✅ Done | ~30 | format.zig and status.zig complete |
| 8 | Mode + Key Bindings | ✅ Done | ~40 | copy mode and key bindings structure complete |
| 9 | Client-Server IPC | ✅ Done | ~30 | IPC protocols, unix sockets, and live client-server communication complete |
| 10 | Commands | ✅ Done | ~74 | All 49 commands registered in CMD_TABLE (including set-window-option / setw, copy-mode, paste-buffer, find-window, show-messages, and list-keys) |
| 11 | Full Integration | ✅ Done | ~30 | integration.zig integration test suite complete |
Total: 1,082 / 1,082 tests passing (verified 2026-10-30, Zig 0.16.0 and 0.17.0, -Doptimize=ReleaseFast; detectNested self-skips inside szn). All Phases 0–11 fully complete.
The per-phase Tests column above is a snapshot taken when each phase landed, not a partition of the current total — later phases and audit sweeps added tests to earlier modules, so those figures do not sum to the current total.
Server.handleStdin).KeyDispatcher and executeAction).layout.zig into Window.splitPane).Display.renderAll rendering grid splits).Server.handleClient to parse and run commands).C-b) detection in main loop~/.szn.conf or ~/.tmux.conf)bind-key, unbind-key, set-option, show-options, source-file, resize-pane)