{{tag>[editor helix cli tui]}}

====== helix ======
Tree-sitter와 language server 지원을 내장한 modal terminal editor. 실행 파일 이름은 ''hx''이다.

===== Summary =====
  * selection-first editing model을 사용하며 여러 cursor와 syntax-aware selection을 지원한다.
  * language server, formatter, debugger 설정 상태를 ''hx --health''로 점검할 수 있다.

===== Installation =====
2026-08-10 기준 공식 Helix package manager 문서가 안내하는 명령이다. Ubuntu/Debian 항목은 release page의 ''.deb'' package 또는 문서에 명시된 third-party PPA를 안내한다.

<code bash>
# Ubuntu PPA / Debian-family
sudo add-apt-repository ppa:maveonair/helix-editor
sudo apt update
sudo apt install helix

# RHEL / Fedora
sudo dnf install helix

# macOS
brew install helix
</code>

<code powershell>
# Windows
winget install Helix.Helix
</code>

<code bash>
hx --version
hx --health
</code>

===== Usage =====
<code bash>
hx FILE
hx FILE1 FILE2
hx +LINE:COL FILE
hx --tutor
</code>

  * ''<color #c3c3c3>**hx**</color> <color #22b14c>[OPTIONS]</color> <color #7092be>FILE...</color>''
  * ''<color #c3c3c3>**hx**</color> <color #22b14c>--tutor</color>''
  * ''<color #c3c3c3>**hx**</color> <color #22b14c>--health</color> <color #7092be>[LANGUAGE]</color>''

===== Basic Editing =====
  * ''hx --tutor''로 대화형 tutorial을 시작한다.
  * <kbd>i</kbd>: Insert mode로 전환한다.
  * <kbd>Esc</kbd>: Normal mode로 돌아간다.
  * '':w'': 저장한다.
  * '':q'': 종료한다.
  * <kbd>Space</kbd>+<kbd>f</kbd>: file picker를 연다.

===== Configuration =====
  * 사용자 설정: ''~/.config/helix/config.toml''
  * language 설정: ''~/.config/helix/languages.toml''
  * runtime 위치 문제는 ''HELIX_RUNTIME''과 ''hx --health'' 출력으로 확인한다.

===== Grammar Management =====
source build나 custom grammar가 필요한 경우에만 grammar를 fetch/build한다.

<code bash>
hx --grammar fetch
hx --grammar build
</code>

===== Troubleshooting =====
  * syntax highlighting이 없으면 runtime files와 grammar 설치 상태를 확인한다.
  * language 기능이 없으면 ''hx --health LANGUAGE''로 language server binary와 formatter 탐지 결과를 확인한다.
  * package에 따라 실행 파일이 ''helix''와 ''hx'' 두 이름으로 제공될 수 있지만 문서와 일반 사용에서는 ''hx''를 기준으로 한다.

===== Help =====
현재 base environment에 ''hx''가 설치되어 있지 않아 live ''hx --help'' 출력은 수집하지 않았다.

===== See Also =====
  * [[vim:nvim:ko|nvim]]
  * [[micro:ko|micro]]
  * [[vim:ko|vim]]

===== History =====
  * codex:: 2026-08-10 Added Helix editor page with official package paths, core usage, configuration, grammar, and health-check workflows.

{{indexmenu>.#1|js}}