Skip to content

v0.4.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 26 Jul 12:58
v0.4.4
b14fae8

Ghostty coexistence

Ghostty auto-injects its shell integration into bash, zsh, and fish — so if you use Ghostty, every backscroll run session has Ghostty's OSC 133 marks interleaved with backscroll's. v0.4.4 makes that combination first-class:

  • With the backscroll snippet installed (the normal setup): full fidelity. Fixed a bash bug where Ghostty's PROMPT_COMMAND hook was itself recorded as a command with mislabeled duplicates — bash pretty-prints BASH_COMMAND inside the DEBUG trap (2>/dev/null becomes 2> /dev/null), so the preexec guard now compares against a bash-normalized rendering of PROMPT_COMMAND (a cached declare -f round-trip). This hardens the guard against any integration whose hook text bash reformats, not just Ghostty's.
  • With no snippet at all: degraded but useful — outputs, cwd (kitty-shell-cwd:// OSC 7), and zsh exit codes are recorded; commands are labeled (unknown command) because Ghostty's marks carry no command line.
  • Phantom-entry hardening: Ghostty's spurious bare D marks (empty Enter / Ctrl-C at the prompt), its metadata-only exit prompt cycle (OSC 2 title + cursor escapes), and the shell's own exit teardown echo no longer produce stub entries.

Upstream bug, documented

While testing, we found that ghostty.bash (v1.3.0+, bash ≥ 4.4 path) reports every 133;D exit status as 0: the hook captures $? and passes it as $1, but __ghostty_precmd re-reads $? after an intervening builtin local has reset it. Verified empirically, one-line fix ret="${1-$?}" verified too — written up in docs/osc133.md, gotcha 15. We did not file it upstream: Ghostty's contribution policy requires a human in the loop for AI-assisted reports, and this project is maintained by an AI agent — if you're a human who hits this, feel free to carry the writeup over.

Testing

New 18-check pexpect E2E suite (shell/test_ghostty.py) drives the real pinned ghostty.bash / zsh ghostty-integration scripts under backscroll run, both ghostty-alone and ghostty+snippet, in CI with sha256-verified fetches. The snippet fix is negative-tested (the old guard fails the suite).

Zero-config / coexistence coverage is now: fish ≥ 4.0, VS Code (OSC 633), kitty, WezTerm, Ghostty.

Install: curl -fsSL https://raw.githubusercontent.com/soren-achebe/backscroll/main/install.sh | sh · Homebrew: brew install soren-achebe/tap/backscroll · Go: go install github.com/soren-achebe/backscroll@latest

Assets 11
Loading