---
title: "Vim 키와 zoxide식 이동을 품은 새 파일 매니저, Kiorg"
published: 2026-05-09T22:15:28.000Z
canonical: https://jeff.news/article/2547
---
# Vim 키와 zoxide식 이동을 품은 새 파일 매니저, Kiorg

Kiorg는 Rust의 egui 프레임워크로 만든 크로스플랫폼 파일 매니저다. Vim 스타일 키바인딩, zoxide 같은 퍼지 디렉터리 이동, 코드·이미지·비디오·PDF·EPUB 미리보기, 내장 터미널까지 넣고도 단일 바이너리 배포를 목표로 한다.

- Kiorg는 성능 중심의 크로스플랫폼 파일 매니저임
  - Rust 생태계의 egui 프레임워크로 만들어졌고, Linux·macOS·Windows를 모두 지원함
  - 목표는 마우스로 폴더를 클릭하는 전통적 파일 매니저보다, 키보드로 빠르게 이동하고 조작하는 쪽에 가까움

- 제일 앞에 내세우는 건 Vim 스타일 키바인딩임
  - 기본 이동 키로 `j`, `k` 같은 Vim식 조작을 쓸 수 있음
  - 검색은 `/` 또는 `Ctrl+f` 같은 식으로 설정 가능함
  - 단축키는 TOML 설정에서 직접 바꿀 수 있어서, 자기 손에 맞게 튜닝하는 흐름을 전제로 함

- zoxide 같은 퍼지 디렉터리 이동이 내장돼 있음
  - 경로를 트리처럼 하나씩 내려가는 대신, 자주 가는 디렉터리를 빠르게 점프하는 기능임
  - 터미널에서 zoxide나 fasd 류 도구를 쓰던 개발자라면 꽤 익숙한 사용감일 가능성이 큼

- 미리보기 기능도 꽤 넓게 잡혀 있음
  - 코드 문법 하이라이트, 이미지, 비디오, PDF, EPUB까지 지원한다고 소개됨
  - 단순히 파일 목록만 보여주는 게 아니라, 탐색 중에 내용 확인까지 한 화면에서 끝내려는 방향임
  - 레이아웃 설정에서 preview 값을 `0.5`로 두면 미리보기 영역을 기본 폭의 50%로 키울 수 있음

> [!IMPORTANT]
> Kiorg의 포지션은 ‘터미널 파일 매니저처럼 빠른 조작’과 ‘GUI 파일 매니저처럼 풍부한 미리보기’를 같이 가져가겠다는 쪽임.

- 배포 방식은 개발자들이 좋아할 만한 단일 바이너리 스타일임
  - 릴리스 페이지에서 플랫폼별 사전 빌드 바이너리를 받을 수 있음
  - 소스에서 설치하려면 `cargo install --locked --git https://github.com/houqp/kiorg.git kiorg`로 설치 가능함
  - “single self-contained binary with battery included”라고 표현한 걸 보면, 의존성 설치로 사용자를 귀찮게 하지 않겠다는 의도가 보임

- 설정은 TOML 파일 기반임
  - Linux는 `~/.config/kiorg/` 아래 설정을 읽음
  - macOS도 `~/.config/kiorg/`가 있으면 그쪽을 쓰고, 아니면 `~/Library/Application Support/kiorg/`를 사용함
  - Windows는 `%APPDATA%\kiorg\` 경로를 사용함

- 정렬, 레이아웃, 단축키, 테마까지 설정 범위가 넓음
  - 정렬 기준은 이름, 수정일, 크기, 없음 중에서 고를 수 있음
  - 정렬 방향은 오름차순 또는 내림차순으로 설정 가능함
  - 테마는 전경색, 배경색, 선택 배경, 폴더 색, 경고·에러·성공 색상까지 직접 지정할 수 있음

- 내장 기능도 파일 탐색기 치고는 꽤 욕심이 많음
  - 멀티 탭, 북마크, 내장 터미널 에뮬레이터, 앱 상태 저장을 지원함
  - 파일 작업의 undo/redo도 제공함
  - 언어에 묶이지 않는 플러그인 시스템도 언급돼 있어서, 장기적으로 확장 가능한 도구를 지향하는 듯함

- 개발 쪽 가이드도 README에 드러남
  - 정적 분석은 `cargo clippy --workspace --all-targets -- -D warnings`로 돌림
  - 테스트는 `cargo test` 또는 `cargo nextest run`을 사용함
  - nextest가 2~3배 빠르다고 추천함
  - 설계 원칙으로는 상속보다 조합, 불필요한 추상화 회피, 긴 작업은 비동기로 처리해서 UI 렌더링을 막지 않는 방향을 제시함

> [!TIP]
> 파일 매니저를 매일 쓰는 개발자라면, Kiorg는 “터미널에서 빠르게 움직이고 싶은데 이미지/PDF 미리보기는 포기하기 싫다”는 니즈에 맞는 후보로 볼 만함.

---
## 기술 맥락

- Kiorg가 egui를 고른 건 크로스플랫폼 GUI와 빠른 반복 개발을 같이 잡으려는 선택으로 보여요. 파일 매니저는 스크롤, 선택, 미리보기 갱신이 계속 일어나니까 UI 반응성이 핵심이거든요.

- Vim 키바인딩과 zoxide식 이동을 넣은 이유는 파일 탐색을 ‘시각적 탐색’보다 ‘명령 기반 이동’에 가깝게 만들기 위해서예요. 개발자는 같은 프로젝트 디렉터리를 반복해서 오가니까, 클릭보다 점프가 훨씬 싸게 먹히는 경우가 많아요.

- TOML 설정을 택한 것도 사용자층을 생각하면 자연스러워요. 이 도구의 핵심 사용자는 설정 파일을 직접 만지는 데 거부감이 적고, 단축키나 테마를 버전 관리하고 싶어 할 가능성이 크거든요.

- 내장 터미널과 미리보기를 같이 넣은 건 파일 매니저를 단순 탐색 도구가 아니라 작업 허브로 보겠다는 뜻이에요. 파일을 찾고, 내용을 보고, 바로 명령을 실행하는 흐름을 한 앱 안에서 줄이려는 거죠.

## 핵심 포인트

- Kiorg는 빠른 렌더링과 키보드 중심 탐색을 앞세운 파일 매니저임
- Linux, macOS, Windows를 지원하고 단일 self-contained 바이너리로 배포됨
- TOML 설정으로 단축키, 정렬 방식, 미리보기 폭, 테마 색상을 커스터마이즈할 수 있음

## 인사이트

터미널 파일 매니저의 생산성과 GUI 미리보기의 편의성을 한 앱에 섞으려는 시도다. 개발자 입장에선 ‘Finder/Explorer는 답답하고, 순수 TUI는 미리보기가 아쉽다’는 지점에 꽤 정확히 꽂혀 있음.
