docs: clarify fork head and test env setup

This commit is contained in:
Lawrence Chen 2026-03-12 03:44:06 -07:00
parent 3c58e8c5ca
commit 473b2a0d1c
2 changed files with 14 additions and 3 deletions

View file

@ -71,7 +71,16 @@ section 3 copy-mode commit, even though the section 4 resize commits were applie
- Emits one `OSC 133;A` fresh-prompt mark for real prompt transitions.
- Uses `OSC 133;P` markers for prompt redraws so async zsh themes do not look like extra prompt lines.
The fork branch HEAD is now the section 5 zsh redraw commit.
### 6) zsh Pure-style multiline prompt redraws
- Commit: `0cf559581` (zsh: fix Pure-style multiline prompt redraws)
- Files:
- `src/shell-integration/zsh/ghostty-integration`
- Summary:
- Handles multiline prompts that use `\n%{\r%}` to return to column 0 before the visible prompt line.
- Places the continuation marker after Pure's hidden carriage return so async redraws do not leave stale preprompt lines behind.
The fork branch HEAD is now the section 6 zsh redraw commit.
## Upstreamed fork changes
@ -93,6 +102,7 @@ These files change frequently upstream; be careful when rebasing the fork:
- `src/shell-integration/zsh/ghostty-integration`
- Prompt marker handling is easy to regress when upstream adjusts zsh redraw behavior. Keep the
`OSC 133;A` vs `OSC 133;P` split intact for redraw-heavy themes.
`OSC 133;A` vs `OSC 133;P` split intact for redraw-heavy themes, and preserve the special
handling for Pure-style `\n%{\r%}` prompt newlines.
If you resolve a conflict, update this doc with what changed.

View file

@ -99,7 +99,8 @@ def _capture_session(*, use_ghostty: bool, wrapper_dir: Path, resources_dir: Pat
env = dict(os.environ)
env["HOME"] = str(home)
env["TERM"] = "xterm-256color"
env["PATH"] = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
env.pop("GHOSTTY_SHELL_FEATURES", None)
env.pop("GHOSTTY_BIN_DIR", None)
if use_ghostty:
env["ZDOTDIR"] = str(wrapper_dir)
env["GHOSTTY_ZSH_ZDOTDIR"] = str(home)