claude-code - 💡(How to fix) Fix ctrl-z suspend leaves terminal in kitty keyboard protocol mode, printing raw escape sequences [1 comments, 2 participants]

TL;DR

To fix the issue where Claude Code doesn't restore terminal state after suspension, trap SIGTSTP to disable the kitty keyboard protocol before suspending and re-enable it on SIGCONT.

Guidance

• Trap SIGTSTP in Claude Code to restore terminal state, including disabling the kitty keyboard protocol, before suspending.
• On SIGCONT, re-enable the kitty keyboard protocol and any other alternate modes to ensure proper terminal functionality.
• As a temporary workaround, users can run printf '\e[?1u\e[?2004l' && stty sane or reset after suspending Claude Code with ctrl-z to manually restore terminal state.
• Verify the fix by checking that pressing Escape in the shell after suspending and resuming Claude Code works as expected, without printing the raw CSI-u escape sequence.

Example

# Example signal handler in bash to trap SIGTSTP and SIGCONT
trap 'printf '\e[?1u\e[?2004l' && stty sane' TSTP
trap 'printf '\e[?1h\e[?2004h'' CONT

Note: This example is a simplified illustration and may need adjustments based on the actual implementation of Claude Code.

Notes

The provided workaround suggests that the issue is specific to terminals supporting the kitty keyboard protocol. The fix should ensure that Claude Code properly handles job control signals to restore terminal state.

Recommendation

Apply the workaround by running printf '\e[?1u\e[?2004l' && stty sane or reset after suspending Claude Code, until a proper fix is implemented in the code to trap SIGTSTP and SIGCONT signals.