Shell:Hooks

Shell Hooks(쉘 훅)은 쉘(Bash, Zsh 등)의 실행 흐름을 가로채어(Intercept) 사용자가 명령어를 입력하거나 디렉토리를 이동할 때 특정 스크립트나 환경 변수 조작을 자동으로 수행하게 만드는 메커니즘이다.

mise, asdf, pyenv, direnv와 같은 런타임 버전 관리 및 환경 변수 관리 도구들은 쉘 프로세스를 물리적으로 중단(Interrupt)하는 대신, 이 훅(Hook) 시스템과 심(Shim) 패러다임을 이용하여 동적인 환경을 구성한다.

개요

쉘 환경에서 특정 디렉토리에 진입했을 때 사용하는 도구의 버전(예: Node.js 18 -> 20)을 즉각적으로 교체하기 위해서는 쉘의 상태(주로 $PATH 환경 변수)를 동적으로 변경해야 한다. 이를 구현하는 두 가지 핵심 메커니즘이 훅(Hooks)과 심(Shims)이다.

동작 메커니즘 1: 쉘 훅 (Shell Hooks) 방식

쉘 훅은 프롬프트가 화면에 출력되기 직전에 특정 함수나 명령을 실행하도록 쉘의 내장 기능을 활용하는 방식이다. 최신 도구(mise, direnv 등)들이 성능 향상을 위해 주로 채택하는 방식이다.

구현 원리

• Bash: PROMPT_COMMAND 환경 변수를 활용한다. 이 변수에 등록된 명령어는 쉘이 $PS1(프롬프트)을 띄우기 직전마다 실행된다.
• Zsh: precmd 훅 함수를 활용한다.

실행 흐름

1. 사용자가 cd 명령어로 디렉토리를 변경한다.
2. 명령이 종료되고 쉘이 새로운 프롬프트를 화면에 그리려고 시도한다.
3. 프롬프트를 그리기 직전, PROMPT_COMMAND (또는 precmd)에 등록된 훅(예: _mise_hook)이 백그라운드에서 실행된다.
4. 훅 함수가 현재 디렉토리의 설정 파일(mise.toml, .envrc 등)을 스캔한다.
5. 필요한 도구 버전이 확인되면 현재 쉘 세션의 $PATH 최상단에 해당 버전의 실제 바이너리 경로를 주입(Export)한다.
6. 사용자가 node를 입력하면, 어떠한 가로채기 과정 없이 즉시 해당 버전의 원본 바이너리가 실행된다.

장단점

• 장점: 런타임 실행 속도가 매우 빠르다. 명령어를 칠 때마다 중간 스크립트를 거치지 않고 실제 바이너리를 직접(Direct) 실행하기 때문이다.
• 단점: Bash, Zsh, Fish 등 각 쉘마다 훅을 구현하는 방식이 달라 도구 개발 시 쉘별로 별도의 지원 스크립트를 작성해야 한다.

적용 예시 (Bash)

# ~/.bashrc 에 추가되는 전형적인 훅 설정 (mise의 경우)
eval "$(mise activate bash)"

# 내부적으로 설정되는 PROMPT_COMMAND의 형태
PROMPT_COMMAND="_mise_hook; $PROMPT_COMMAND"

동작 메커니즘 2: 심(Shims) 패러다임

전통적인 버전 관리 도구(asdf, pyenv, rbenv 등)가 사용하는 범용적인 접근법이다. 쉘의 기능을 확장하는 대신, 운영체제의 $PATH 검색 우선순위를 이용한다.

구현 원리

특정 디렉토리(예: ~/.local/share/mise/shims/)를 $PATH 환경 변수의 가장 앞부분(우선순위 1위)에 영구적으로 등록하고, 그 안에 사용자가 설치한 모든 도구와 이름이 동일한 가짜 실행 파일(Shim 스크립트)들을 생성해 둔다.

실행 흐름

1. 사용자가 node 명령어를 입력한다.
2. 쉘은 $PATH를 순서대로 검색하다가 가장 먼저 발견한 Shim 파일(.../shims/node)을 실행한다.
3. Shim 스크립트는 내부적으로 버전 관리 도구(본체)를 호출하여 "현재 디렉토리 기준으로 실행해야 할 진짜 원본 바이너리의 경로는 어디인가?"를 질의한다.
4. 올바른 버전을 찾으면, Shim 스크립트는 exec 명령을 사용하여 진짜 바이너리로 프로세스를 교체(Forwarding)하여 실행을 마친다.

장단점

• 장점: 쉘 종류(Bash, Zsh, Fish 등)에 구애받지 않고 $PATH만 설정할 수 있으면 어디서든 동작한다. (호환성 우수)
• 단점: 사용자가 명령어를 입력할 때마다 Shim 스크립트 실행 -> 본체 호출 -> 경로 계산 -> 원본 실행이라는 오버헤드가 발생하여 실행 속도가 미세하게 느려진다.

주요 도구별 동작 방식 비교

See also

• 환경 변수
• Bash
• Zsh
• Shell
• Linux
• Environment Management