install-sh/DOCS/UNIX-01-TERMINAL-FILE.md

# 📁 [macOS / Linux] 1. 터미널 관리 & 파일 유틸리티

[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-01-TERMINAL-FILE.md)

---

## ⚡ 빠른 원클릭 설치 (Bash)

```bash
# 1.1. tmux (터미널 멀티플렉서 + 커스텀 .tmux.conf)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.sh?ref_type=heads" | bash

# 1.2. rmux (Rust 기반 차세대 터미널 멀티플렉서)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-rmux.sh?ref_type=heads" | bash

# 1.3. Helix (모달 터미널 텍스트 에디터 + 런타임)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-helix.sh?ref_type=heads" | bash

# 1.4. superfile (터미널 기반 듀얼 패널 파일 관리자)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-superfile.sh?ref_type=heads" | bash

# 1.5. dua (초고속 디스크 사용량 분석기)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-dua.sh?ref_type=heads" | bash
```

---

## 📖 도구별 상세 사용법 및 단축키

### 1.1. [tmux](https://github.com/tmux/tmux)
터미널 멀티플렉서입니다. 하나의 터미널 창 내에서 백그라운드 세션을 유지하고 자유롭게 분할(패널)하여 사용할 수 있습니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **세션 관리** — 세션을 백그라운드로 보존 및 필요 시 재접속
  * **화면 분할** — 터미널 화면 수평/수직 분할 및 동시 작업
  * **Vim 스타일 조작** — h/j/k/l 방향키를 통해 직관적으로 패널 이동 가능

```bash
tmux                  # 새 세션 가동
tmux new -s <name>    # 이름 지정 세션 시작
tmux attach -t <name> # 특정 세션 다시 연결
tmux ls               # 가동 중인 세션 목록 보기
```

| 단축키 | 동작 |
| :--- | :--- |
| `Ctrl-a` | Prefix key (기본 단축키 Ctrl-b에서 변경됨) |
| `Prefix \|` | 화면 수평(좌우) 분할 |
| `Prefix -` | 화면 수직(위아래) 분할 |
| `Prefix h/j/k/l` | 패널 간 이동 (Vim 스타일) |
| `Prefix r` | `.tmux.conf` 설정 파일 즉시 리로드 |
| `Prefix Space` | 활성화된 패널 레이아웃 변경 |
| `Prefix o` | 활성화된 패널 회전 전환 |
| `Prefix ,` | 현재 창의 이름 변경 |
| `Prefix &` | 현재 활성화된 창 완전히 닫기 |

> 💡 `install-tmux.sh` 스크립트는 최적화된 커스텀 `.tmux.conf` 파일을 사용자 홈 디렉토리에 배포합니다. (기존 설정 파일이 있다면 `.tmux.conf.bak.*`로 자동 백업됩니다.)

---

### 1.2. [rmux](https://rmux.io)
tmux의 강력하고 현대적인 대안으로 설계된 Rust 기반 터미널 멀티플렉서입니다. 백그라운드 데몬 프로세스를 기반으로 쉘 세션을 지속적으로 유지하며, 브라우저에서 터미널을 접속할 수 있는 웹 셰어(Web Share) 기능과 전용 Rust SDK를 지원합니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-rmux.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **tmux 호환성** — 기존 tmux 명령어 체계를 상당 부분 그대로 지원하여 완벽하게 호환 작동
  * **Rust 기반 고성능** — 가볍고 빠르며 Rust 기반으로 오동작이 극히 적음
  * **웹 셰어 기능 내장** — 추가적인 툴 설치 없이 터미널 세션을 브라우저에 실시간으로 공유 가능

```bash
rmux                  # 새 세션 가동
rmux attach           # 마지막 세션 다시 연결
rmux list-sessions    # 세션 목록 보기
```

| 단축키 | 동작 |
| :--- | :--- |
| `Ctrl-b` | Prefix key (기본값) |
| `Prefix %` | 화면 수평(좌우) 분할 |
| `Prefix "` | 화면 수직(위아래) 분할 |
| `Prefix d` | 현재 세션에서 이탈 (Detach) |
| `Prefix o` | 다음 패널로 포커스 이동 |
| `Prefix x` | 현재 활성화된 패널 완전히 닫기 |

---

### 1.3. [Helix](https://github.com/helix-editor/helix)
터미널 환경에서 현대적인 사용성을 제공하는 모달(Modal) 텍스트 에디터입니다. 별도의 플러그인 설정 없이도 LSP(Language Server Protocol), 구문 트리 파서(Tree-sitter) 및 수려한 디자인 테마가 내장되어 있어 즉시 사용 가능합니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-helix.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **LSP 기본 내장** — 자동 완성, 정의 이동, 타입 힌트 등 IDE급 개발 지원
  * **Tree-sitter 구문 분석** — 실시간 구문 분석을 통한 완벽한 색상 하이라이팅 및 스마트 영역 탐색
  * **모달 편집 모드** — Vim과 유사하면서도 더 현대적인 다중 커서 및 텍스트 객체 편집 지원

```bash
hx <file> # 실행 명령어
```

| 단축키 | 동작 |
| :--- | :--- |
| `i` | Insert 모드 진입 |
| `Esc` | Normal 모드 복귀 |
| `d` | 현재 선택 영역 삭제 (지우기) |
| `y` | 현재 선택 영역 복사 (Yank) |
| `p` | 복사한 텍스트 붙여넣기 (Paste) |
| `w` / `b` | 다음 단어 / 이전 단어로 이동 |
| `u` / `U` | 작업 취소 (Undo) / 다시 실행 (Redo) |
| `Space f` | 전역 파일 찾기 (File picker) |
| `Space /` | 현재 버퍼 전역 검색 |
| `:w` / `:q` | 파일 저장 / 에디터 종료 |

> 💡 **설치 구성 팁:** `install-helix.sh`는 실행 바이너리(`~/.local/bin/hx`)뿐만 아니라 언어별 구문 및 테마 파일이 모인 런타임 폴더를 `~/.config/helix/runtime` 경로에 자동 배치합니다.

---

### 1.4. [superfile](https://github.com/yorukot/superfile)
수려하고 미려한 디자인을 선사하는 고기능 터미널 파일 관리자입니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-superfile.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **듀얼 패널** — 대칭형 레이아웃으로 직관적인 디렉토리 간 파일 조작
  * **Vim 키바인딩** — h/j/k/l 탐색 키 및 복사/붙여넣기 직관적 조작
  * **시각적 미리보기** — 파일의 코드 하이라이팅 및 텍스트 미리보기 탑재

```bash
spf # 실행 명령어 (superfile이 아닌 spf를 사용합니다)
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `h` `j` `k` `l` | 좌 / 하 / 상 / 우 디렉토리 이동 |
| `Enter` | 디렉토리 진입 및 대상 파일 열기 |
| `y` | Yank (클립보드에 파일 복사) |
| `d` | Delete (대상 파일 삭제) |
| `r` | Rename (이름 변경) |
| `/` | 실시간 빠른 검색 |
| `Tab` | 듀얼 패널 포커스 스왑 |

> 💡 **중요:** 터미널 아이콘이 깨져 보일 경우 터미널 폰트를 **Nerd Font** 계열로 설정해 주세요.  
> 💡 **macOS iTerm2 한글 깨짐 팁:** `Settings` > `Profile` > `Text` > `Normalization`에서 **NFC** 옵션으로 설정하면 정상 표기됩니다.

---

### 1.5. [dua](https://github.com/byron/dua-cli)
SSD와 시스템 성능을 최대로 활용하여 유실된 용량을 추적하는 병렬 스캔 방식의 초고속 디스크 분석 유틸리티입니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-dua.sh?ref_type=heads" | bash
  ```

```bash
dua                     # 현재 위치 사용량 검사
dua /path/to/dir        # 특정 디렉토리 지정 검사
dua i                   # 대화형(Interactive) TUI 모드 구동
```

| 단축키 | 동작 |
| :--- | :--- |
| `↑` `↓` 또는 `j` `k` | 디렉토리 트리 위/아래 이동 |
| `?` | 단축키 도움말 팝업 |
| `d` | 선택한 디렉토리/파일 즉시 영구 삭제 |
| `q` / `Esc` | 프로그램 종료 |

---

[⬅️ 메인 README로 돌아가기](../README.md) | [다음 카테고리: 2. 시스템 & 컨테이너 DevOps ➡️](./UNIX-02-SYSTEM-DEVOPS.md)