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

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

[⬅️ 메인 README로 돌아가기](../README.md) | [🍎 macOS / 🐧 Linux 가이드 보기](./UNIX-01-TERMINAL-FILE.md)

---

## ⚡ 빠른 원클릭 설치 (PowerShell / CMD)

### 1.1. tmux (Windows는 psmux 설치)
* **CMD 창에서 실행:**
  ```cmd
  powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-tmux.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.ps1' -OutFile $t; & $t"
  ```
* **PowerShell 창에서 실행:**
  ```powershell
  $t="$env:TEMP\install-tmux.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
  ```

### 1.2. rmux
* **CMD 창에서 실행:**
  ```cmd
  powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-rmux.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-rmux.ps1' -OutFile $t; & $t"
  ```
* **PowerShell 창에서 실행:**
  ```powershell
  $t="$env:TEMP\install-rmux.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-rmux.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
  ```

### 1.3. Helix
* **CMD 창에서 실행:**
  ```cmd
  powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-helix.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-helix.ps1' -OutFile $t; & $t"
  ```
* **PowerShell 창에서 실행:**
  ```powershell
  $t="$env:TEMP\install-helix.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-helix.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
  ```

### 1.4. superfile
* **CMD 창에서 실행:**
  ```cmd
  powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-superfile.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-superfile.ps1' -OutFile $t; & $t"
  ```
* **PowerShell 창에서 실행:**
  ```powershell
  $t="$env:TEMP\install-superfile.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-superfile.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
  ```

### 1.5. dua
* **CMD 창에서 실행:**
  ```cmd
  powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-dua.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-dua.ps1' -OutFile $t; & $t"
  ```
* **PowerShell 창에서 실행:**
  ```powershell
  $t="$env:TEMP\install-dua.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-dua.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
  ```

---

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

### 1.1. [tmux (psmux)](https://github.com/psmux/psmux)
Windows 환경에서는 Rust 기반 네이티브 가상 터미널 멀티플렉서인 `psmux`(`tmux.exe` 별칭 포함)가 `$HOME\.local\bin`에 설치되고 PATH에 자동 등록됩니다. 기존 `.tmux.conf` 설정 파일과 높은 수준으로 호환되어 동일한 Vim 스타일 단축키를 그대로 사용할 수 있습니다.

```powershell
tmux                  # 새 세션 가동 (또는 psmux)
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 &` | 현재 활성화된 창 완전히 닫기 |

---

### 1.2. [rmux](https://rmux.io)
tmux의 현대적인 대안으로 설계된 Rust 기반 터미널 멀티플렉서입니다.

```powershell
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) 텍스트 에디터입니다. `install-helix.ps1`은 `hx.exe`를 `$env:USERPROFILE\.local\bin`에 배포하고 필수 런타임 파일들을 `%APPDATA%\helix\runtime` 경로에 자동으로 구성합니다.

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

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

---

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

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

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

> 💡 **중요:** Windows Terminal 등에서 아이콘이 깨져 보일 경우 폰트를 **Nerd Font** 계열로 설정해 주세요.

---

### 1.5. [dua](https://github.com/byron/dua-cli)
병렬 스캔을 지원하는 초고속 디스크 사용량 분석 유틸리티입니다.

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

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

---

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