Compatibility issue: Warp Terminal hangs when sourcing NeuroSkill zsh hook

[jelanijohn]

When the NeuroSkill zsh hook is enabled, Warp Terminal hangs indefinitely during shell startup on macOS.

The issue appears to be related to the PTY recording wrapper (skill-tty) being launched from the shell hook. Preventing the wrapper from starting allows Warp to launch normally.

Reproduction:

• Install NeuroSkill and enable the generated zsh hook
• Open Warp Terminal
• Warp hangs during startup and never reaches a usable shell

My local fix in ~/.zshrc:

# neuroskill shell hook
if [[ "$TERM_PROGRAM" == "WarpTerminal" ]]; then
  export NEUROSKILL_SKIP_RECORDING=1
fi

if [[ -o interactive && -f "$HOME/.skill/shell-hooks/neuroskill.zsh" ]]; then
  source "$HOME/.skill/shell-hooks/neuroskill.zsh"
fi

[eugenehp]

Thank you for the feedback! Cab you share your version of zsh, so we can replicate it in the tests.

[jelanijohn]

zsh 5.9 (arm64-apple-darwin24.0)