zsh-hangul

생각해보면 터미널에서는 한글을 쓸 일이 잘 없습니다.

영어를 타이핑 해야되는데 한글로 타이핑된경우 자동으로 수정합니다.

Auto correct hangul(한글, korean) to english when it was supposed to be typed in english.

ex) ㅎㅇ-> gd, ㅣㄴ-> ls

zsh에서만 동작합니다 bash 사용자는 bash 버전을 사용하세요. 참고로 macOS 는 카타리나 버전부터 zsh이 기본쉘로 변경되었습니다.

Installation

자세한 설치 가이드는 INSTALL.md를 참고해주세요.

한글이 허용되는 경우

1. 문자열에서 사용

문자열 안에서는 한글이 그대로 유지됩니다. 다음 3가지 경우에 문자열로 인식합니다.

• "문자열" (이중 따옴표)
• '문자열' (단일 따옴표)
• `문자열` (백틱)

2. 복사 붙여넣기

복사 붙여넣기로 입력된 텍스트는 한영변환되지 않습니다. 직접 타이핑한 경우에만 한영변환이 적용되어, 의도하지 않은 변환을 방지합니다.

• ✅ 직접 타이핑: ㅎㅇ → gd로 자동 변환
• ✅ 복사 붙여넣기: 한글 텍스트가 그대로 유지됨

3. AI 툴의 입력

AI가 한영을 실수로 입력할 일은 없다고 가정하고 한영자동 변환을 해주지 않습니다.

cursor만 적용해두었습니다. 다른 툴에서 필요한경우 이슈나 PR을 올려주세요! 😄

Reference

http://zsh.sourceforge.net/Doc/zsh_us.pdf