install-sh/README.md

# 필수 터미널 도구

터미널에서 사용하는 유용한 CLI/TUI 도구 모음입니다. 단 한 줄의 명령어로 다양한 개발 생산성 도구를 설치하고 관리할 수 있습니다.

---

## 📂 카테고리별 지원 도구 목록

### 📁 1. 터미널 관리 & 파일 유틸리티
* **[tmux](https://github.com/tmux/tmux)** - 강력한 터미널 멀티플렉서 (세션 관리 및 화면 분할, Windows는 psmux로 설치)
* **[rmux](https://rmux.io)** - tmux의 대안으로 이용 가능한 Rust 기반의 현대적이고 빠른 터미널 멀티플렉서
* **[Helix](https://github.com/helix-editor/helix)** - 현대적이고 강력한 터미널 기반 모달 텍스트 에디터 (LSP 및 구문 강조 기본 내장)
* **[superfile](https://github.com/yorukot/superfile)** - 모던하고 수려한 터미널 기반 파일 관리자 (Vim 키바인딩 지원)
* **[dua](https://github.com/byron/dua-cli)** - 병렬 스캔을 지원하는 초고속 디스크 사용량 분석 도구

### 🐳 2. 시스템 & 컨테이너 DevOps
* **[bottom](https://github.com/ClementTsang/bottom)** - CPU, 메모리, 네트워크 등을 실시간 모니터링하는 TUI
* **[all-smi](https://github.com/lablup/all-smi)** - 이종 GPU/NPU 가속기 및 리소스를 실시간 모니터링하는 통합 TUI
* **[Docker](https://www.docker.com/)** - 컨테이너 플랫폼 (Linux 자동 설치 지원, Mac/Windows 가이드 제공)
* **[lazydocker](https://github.com/jesseduffield/lazydocker)** - 도커 컨테이너, 이미지, 볼륨을 시각적으로 제어하는 TUI
* **[ctop](https://github.com/bcicen/ctop)** - 실시간 컨테이너 메트릭 및 자원 모니터링 TUI

### 🛠️ 3. 개발 유틸리티 & 웹 터미널
* **[lazygit](https://github.com/jesseduffield/lazygit)** - Git 버전 관리를 키보드로 능숙하게 제어하는 시각적 TUI
* **[uv](https://docs.astral.sh/uv/)** - 초고속 Rust 기반 Python 패키지 & 프로젝트 통합 관리자

### 🤖 4. AI 개발 에이전트 (AI Agents)
* **[Antigravity CLI (agy)](https://antigravity.google)** - Antigravity 2.0 플랫폼의 경량화 터미널 코딩 에이전트 CLI
* **[Claude Code](https://code.claude.com/)** - Anthropic의 차세대 터미널 기반 대화형 AI 코딩 어시스턴트 CLI
* **[Codex CLI](https://developers.openai.com/codex/cli)** - OpenAI의 공식 터미널 기반 로컬 대화형 코딩 에이전트 CLI
* **[OpenCode](https://opencode.ai/)** - 75개 이상의 LLM 프로바이더를 지원하는 터미널 TUI 기반 오픈소스 AI 코딩 에이전트
* **[pi](https://pi.dev/)** - 대화형 CLI AI 코딩 어시스턴트 및 추천 플러그인 패키지 일괄 설치 도구
* **[Open Code Review (ocr)](https://github.com/alibaba/open-code-review)** - AI 기반의 오픈소스 코드 리뷰 자동화 도구

---

## 🚀 설치 가이드

### 🍎 MacOS / 🐧 Linux (Bash)

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

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

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

* **Helix:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-helix.sh?ref_type=heads" | bash
  ```

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

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

#### 🐳 2. 시스템 & 컨테이너 DevOps

* **Docker (Linux 전용 — macOS/Windows 사용자는 하단 사용법 가이드 참고):**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash
  ```

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

* **all-smi:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.sh?ref_type=heads" | bash
  ```

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

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

#### 🛠️ 3. 개발 유틸리티 & 웹 터미널

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

* **uv:**
  ```bash
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```
  > 💡 설치 후 `${HOME}/.local/bin`이 PATH에 없으면 추가하세요:
  > ```bash
  > echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  > source ~/.bashrc
  > ```

#### 🤖 4. AI 개발 에이전트 (AI Agents)

* **Antigravity CLI (agy):**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash
  ```

* **Claude Code:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
  ```

* **Codex CLI:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
  ```

* **OpenCode:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash
  ```

* **pi (Pi Coding Agent + 추천 패키지):**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
  ```

* **Open Code Review (ocr):**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.sh?ref_type=heads" | bash
  ```

---

### 💻 Windows (PowerShell / CMD)

#### 📁 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
    $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
    ```
  > 💡 **Windows tmux(psmux) 참고:** Windows 환경에서는 Rust 기반 네이티브 Windows 터미널 멀티플렉서인 `psmux`가 설치되며, 실행 파일들이 `$HOME\.local\bin`에 배포되고 PATH에 자동 등록됩니다.

* **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
    $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
    ```

* **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
    $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
    ```

* **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
    $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
    ```

* **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
    $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
    ```

#### 🐳 2. 시스템 & 컨테이너 DevOps

* **Docker:**
  [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 수동 설치하거나, WSL2 내부에서 리눅스용 `install-docker.sh`를 실행하세요.

* **bottom:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-bottom.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-bottom.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **all-smi:**
  * **CMD 창에서 설치 시 (.ps1 실행 또는 .bat 실행):**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-all-smi.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.ps1' -OutFile $t; & $t"
    ```
    배치 파일(.bat) 다운로드 및 실행:
    ```cmd
    curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.bat" -o "%TEMP%\install-all-smi.bat" && "%TEMP%\install-all-smi.bat"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-all-smi.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **ctop:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-ctop.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-ctop.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **lazydocker:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-lazydocker.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-lazydocker.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

#### 🛠️ 3. 개발 유틸리티 & 웹 터미널

* **lazygit:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-lazygit.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-lazygit.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **uv:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    irm https://astral.sh/uv/install.ps1 | iex
    ```
  > 💡 설치 후 `$env:USERPROFILE\.local\bin`이 PATH에 없으면 추가하세요:
  > ```powershell
  > [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User')
  > ```

#### 🤖 4. AI 개발 에이전트 (AI Agents)

* **Antigravity CLI (agy):**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-agy.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-agy.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **Claude Code:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-claude-code.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-claude-code.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **Codex CLI:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-codex-cli.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-codex-cli.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **OpenCode:**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-opencode.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-opencode.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **pi (Pi Coding Agent + 추천 패키지):**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-pi.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-pi.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

* **Open Code Review (ocr):**
  * **CMD 창에서 설치 시:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-ocr.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.ps1' -OutFile $t; & $t"
    ```
  * **파워쉘 창에서 설치 시:**
    ```powershell
    $t="$env:TEMP\install-ocr.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

---

## 📖 도구별 상세 사용법 및 팁

---

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

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

* **세션 관리** — 세션을 백그라운드로 보존 및 필요 시 재접속
* **화면 분할** — 터미널 화면 수평/수직 분할 및 동시 작업
* **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` 스크립트는 최적화된 커스텀 `.tmux.conf` 파일을 사용자 홈 디렉토리에 배포합니다. (기존 설정 파일이 있다면 `.tmux.conf.bak.*`로 자동 백업됩니다.)  
> 💡 **Windows psmux 연동 참고:** Windows에서는 네이티브 가상 터미널 환경을 선사하는 `psmux`가 설치되며, 기존 `.tmux.conf` 파일과 높은 수준으로 호환되어 동일한 설정과 vim 키바인딩을 사용할 수 있습니다.

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

* **tmux 호환성** — 기존 tmux 명령어 체계를 상당 부분 그대로 지원하여 완벽하게 호환 작동
* **Rust 기반 고성능** — 가볍고 빠르며 Rust 기반으로 오동작이 극히 적음
* **웹 셰어 기능 내장** — 추가적인 툴 설치 없이 터미널 세션을 브라우저에 실시간으로 공유 가능

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

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

> 💡 **tmux 대안 기능:** rmux는 Rust 프로젝트에서 SDK로 제어할 수도 있어 터미널 오케스트레이션 및 테스트 자동화에 최적화되어 있습니다.

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

* **LSP 기본 내장** — 자동 완성, 정의 이동, 타입 힌트 등 IDE급 개발 지원
* **Tree-sitter 구문 분석** — 실시간 구문 분석을 통한 완벽한 색상 하이라이팅 및 스마트 영역 탐색
* **모달 편집 모드** — Vim과 유사하면서도 더 현대적인 다중 커서 및 텍스트 객체 편집 지원

```bash
hx # 실행 명령어
```

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

> 💡 **설치 구성 팁:** Helix 에디터는 실행 바이너리(`hx` / `hx.exe`)뿐만 아니라 언어별 구문 및 테마 파일이 모인 `runtime` 디렉토리가 올바른 경로에 배포되어야 합니다. 당사 배포 스크립트는 macOS/Linux의 경우 `~/.config/helix/runtime`, Windows의 경우 `%APPDATA%\helix\runtime`으로 런타임 폴더를 자동 탐색하여 백업 및 배치합니다.

#### 1.4. superfile
수려하고 미려한 디자인을 선사하는 고기능 터미널 파일 관리자입니다.

* **듀얼 패널** — 대칭형 레이아웃으로 직관적인 디렉토리 간 파일 조작
* **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
SSD와 시스템 성능을 최대로 활용하여 유실된 용량을 추적하는 병렬 스캔 방식의 초고속 디스크 분석 유틸리티입니다.

* **초고속 스캔** — 대용량 디스크도 수 초 만에 고속으로 스캔 처리
* **대화형 TUI 모드** — 디렉토리 깊이를 탐색하며 불필요한 용량 점유 요소를 바로 제거

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

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

---

### 🐳 2. 시스템 & 컨테이너 DevOps

#### 2.1. bottom
기존의 `top`이나 `htop`을 완벽하게 대체하는 화려하고 가벼운 호스트 시스템 리소스 모니터링 TUI 도구입니다.

* **풀 그래픽 차트** — CPU 코어별 사용률, RAM/Swap, 네트워크 흐름, 디스크 I/O 실시간 그래프화
* **정교한 프로세스 제어** — 프로세스를 정렬하고 직접 제어 및 강제 종료 가능

```bash
btm # 실행 명령어
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `F1` ~ `F5` | 메트릭 모니터링 탭 이동 |
| `↑` `↓` | 프로세스 목록 선택 이동 |
| `k` | 선택한 대상 프로세스 강제 종료 (Kill) |
| `/` | 실시간 프로세스명 검색 필터링 |

#### 2.2. all-smi
Lablup에서 개발한 이종(Heterogeneous) 가속기 및 GPU/NPU 자원 통합 모니터링 CLI/TUI 도구입니다. `nvidia-smi`를 대체/확장하여 다양한 AI 가속기 및 클러스터 노드 관제를 지원합니다.

* **이종 가속기 지원** — NVIDIA GPU, Apple Silicon, Intel Gaudi, Google TPU, Rebellions NPU, Furiosa NPU, Tenstorrent NPU 등 모니터링 지원
* **실시간 인터랙티브 TUI** — GPU/NPU 사용률, 메모리, 온도, 전력 소모량 실시간 그래프 시각화
* **클러스터 메트릭 관제** — 원격 시스템 관제 및 프로메테우스(Prometheus) 메트릭 추출 기능 연동 지원

```bash
all-smi             # 인터랙티브 모니터링 TUI 세션 시작
all-smi --help      # 도움말 및 사용 가능 옵션 확인
```

#### 2.3. Docker
컨테이너 기반 애플리케이션 가상화 플랫폼입니다.

* **자동 설치 지원:** `install-docker.sh`는 Linux 환경에 필수적인 Docker Engine 및 Compose를 무인 설치합니다.

```bash
docker run hello-world     # 동작 유효성 테스트
docker ps                   # 가동 중인 컨테이너 목록
docker compose up -d        # 멀티 컨테이너 환경 백그라운드 구동
docker build -t <name> .    # 로컬 Dockerfile 빌드
```

> 💡 **운영체제별 사용 가이드:**
> * **macOS:** [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/) 또는 초경량 대안인 [OrbStack](https://orbstack.dev/) 설치를 권장합니다.
> * **Windows:** [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 단독 구동하시거나 WSL2 내부에서 리눅스 자동 설치 스크립트를 경유하여 활용하실 수 있습니다.
> * **Linux:** 설치 완료 후 스크립트가 로그인된 유저를 자동으로 `docker` 권한 그룹에 할당합니다. 터미널 세션을 재로그인하시면 `sudo` 없이 편하게 제어하실 수 있습니다.

#### 2.3. ctop / lazydocker
가동 중인 컨테이너들을 효율적으로 모니터링하고 관리할 수 있도록 지원하는 특화 TUI 듀오입니다.

| 도구명 | 특징 및 주요 권장 환경 |
| :--- | :--- |
| **ctop** | 실시간 리소스 메트릭(CPU, RAM, 네트워크 트래픽 등) 모니터링에 고도로 특화됨 |
| **lazydocker** | 컨테이너 상태 조회는 물론이고 시작, 정지, 재시작, 로그 보기, 내부 셸 진입 등 전반적인 컨테이너 수명 주기 관리에 적합함 |

##### [ctop 사용법]
```bash
ctop # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `↑` `↓` | 컨테이너 리스트 이동 |
| `l` | 선택된 컨테이너의 실시간 로그 화면 로드 |
| `a` | 숨겨진 비활성 컨테이너까지 전부 표시 |
| `f` | 특정 컨테이너 이름 검색 필터링 |
| `S` | 선택된 컨테이너 정지 |
| `R` | 선택된 컨테이너 즉시 재시작 |

##### [lazydocker 사용법]
```bash
lazydocker # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↑` `↓` | 목록 패널 탐색 |
| `Enter` | 컨테이너 상세 로그 및 자원 소비 통계 보기 |
| `s` | 컨테이너 인스턴스 정지 (Stop) |
| `r` | 컨테이너 인스턴스 신속 재시작 (Restart) |
| `e` | 컨테이너 내부 터미널 즉시 실행 진입 (Exec) |
| `x` | 컨테이너 강제 파괴 및 제거 (Remove) |
| `[` `]` | 탭 및 패널 간 수평 포커스 이동 |

---

### 🛠️ 3. 개발 유틸리티 & 웹 터미널

#### 3.1. lazygit
복잡하고 가끔은 위험할 수 있는 Git CLI 명령어들을 직관적인 단축키와 패널 구성을 통해 신속하고 깔끔하게 제어하도록 도와주는 최고의 Git TUI 도구입니다.

* **직관적인 변경사항 추적** — 수정된 파일들의 코드 변경점을 실시간 visual diff로 파악
* **신속한 형상 관리** — Stage, Unstage, Commit, Push, Pull, Branch 스왑, Stash 작업을 터치리스로 신속 처리
* **Rebase 지원** — 충돌 해결 및 Interactive Rebase(스쿼시 등)의 복잡성을 혁신적으로 단축

```bash
lazygit # 가동 명령어
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↓` `↑` `→` `←` | 파일 / 스테이지 / 커밋 / 브랜치 패널 포커스 이동 |
| `Space` | 현재 선택 파일 Stage / Unstage 전환 |
| `c` | 커밋 메시지 작성 윈도우 팝업 |
| `P` / `p` | 원격 저장소에 Push / Pull 요청 실행 |
| `?` | 전체 단축키 치트 시트 일람 로드 |

---

### 🤖 4. AI 개발 에이전트 (AI Agents)

#### 4.1. Antigravity CLI
Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다.

* **로컬 터미널 밀착 코딩** — 별도의 무거운 데스크톱 GUI 없이 터미널 내부에서 완벽한 페어 프로그래밍 실현
* **보안 Google 계정 연동** — 첫 가동 시 Google Sign-In 보안 흐름이 브라우저와 클라이언트 단에서 연동 가동됨
* **유연한 자동화** — CI/CD 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원

```bash
agy                  # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항"     # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help           # 도움말 및 명령어 명세 로드
```

#### 4.2. Claude Code
Anthropic사에서 개발한 공식 터미널 기반 AI 개발 어시스턴트 툴킷입니다. npm이 깔려있지 않은 시스템에서도 curl(macOS/Linux) 및 PowerShell(Windows) 공식 네이티브 설치 방식을 사용하여 즉시 CLI 코딩 환경에 접목할 수 있습니다.

* **고속 컨텍스트 추론** — Anthropic Claude 3.5 Sonnet 등의 고성능 AI 추론 엔진을 터미널 내에서 바로 가동
* **네이티브 실행 제어** — 시스템 아키텍처 환경과 로컬 파일 구조를 깊이 이해하고 즉시 빌드 및 리서치 수행
* **안전성 확보** — 강력한 로컬 샌드박스 정책 및 권한 승인 모드를 통해 안전한 자동 코딩 보장

```bash
claude # 가동 명령어 (로그인 후 세션 시작)
```

##### [Claude Code 기본 사용법]
```bash
claude                  # 대화형 코딩 세션 시작 (OAuth 로그인 연동)
claude -p "질문/작업"   # 터미널 창을 열지 않고 즉시 지시 수행 및 결과 출력 (단발 실행)
claude --help           # 도움말 및 사용법 로드
```

#### 4.3. Codex CLI
OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다. Rust 기반으로 제작되어 높은 성능을 자랑하며, npm 없이도 단일 실행(curl) 및 PowerShell(Windows) 공식 인스톨러 방식을 활용해 네이티브하게 작동 가능합니다.

* **강력한 시스템 통합** — 터미널 로컬 환경에서 사용자의 지시 하에 파일 편집, 아키텍처 리서치 및 CLI 빌드 실행 지원
* **다양한 모델 스왑** — 세션 내에서 GPT-5.4, GPT-5.3-Codex 등으로 자유롭게 두뇌 변경 및 추론 조작 지원
* **멀티모달 시각 분석** — 스크린샷이나 와이어프레임 설계도를 입력받아 UI 코드를 고속으로 구현 및 피드백

```bash
codex # 가동 명령어
```

##### [Codex CLI 기본 사용법]
```bash
codex auth              # OpenAI ChatGPT 또는 API 계정 연동 로그인
codex                   # 대화형 코딩 TUI 세션 시작
codex -p "작업명령"     # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
```

#### 4.4. OpenCode
터미널, IDE, 데스크톱 환경을 아우르는 오픈소스 AI 코딩 에이전트 CLI입니다. 특정 AI 프로바이더에 종속되지 않고 OpenAI, Anthropic, Google(Gemini)뿐 아니라 Ollama 등 로컬 모델을 포함한 75개 이상의 LLM 프로바이더를 자유롭게 연결하여 코드베이스 분석, 파일 편집, 터미널 명령 실행 등을 수행합니다.

* **터미널 중심 TUI 환경** — 반응성이 뛰어나고 직관적인 터미널 UI를 통해 대화형으로 코딩 작업 수행
* **멀티 모델 & 프로바이더 자유도** — OpenAI, Claude, Gemini 및 Ollama 로컬 LLM 등 75종 이상의 다양한 모델을 유연하게 전환
* **역할별 에이전트 모드** — 분석 및 읽기 전용인 'Plan' 모드와 직접 수정 및 빌드를 실행하는 'Build' 모드 분리 운용
* **프로젝트 인지력** — 프로젝트 내 `AGENTS.md` 생성을 통해 코드베이스 아키텍처 및 코딩 컨벤션을 스스로 학습

```bash
opencode # 가동 명령어
```

##### [OpenCode 기본 사용법]
```bash
opencode             # 대화형 코딩 TUI 세션 시작
opencode auth login  # AI 모델 프로바이더 계정 및 API 키 연동
opencode --help      # 도움말 및 사용 가능 옵션 확인
```

#### 4.5. Pi Coding Agent
CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 `install-pi` 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.

##### [일괄 설치되는 추천 패키지 리스트]

| 패키지 | 설명 |
| :--- | :--- |
| [pi-subagents](https://pi.dev/packages/pi-subagents) | 오케스트레이션, 코드 리뷰, Auditor 등 세분화된 하위 태스크를 자식 에이전트들에 분할 위임 |
| [context-mode](https://pi.dev/packages/context-mode) | 컨텍스트 윈도우 보호 가드 및 session sandbox, BM25 로컬 검색 연동 |
| [pi-mcp-adapter](https://pi.dev/packages/pi-mcp-adapter) | 단 하나의 통합 MCP 프록시 툴을 가동하여 토큰 소모량을 아끼고 다양한 서버와 통합 |
| [pi-web-access](https://pi.dev/packages/pi-web-access) | Exa, Perplexity, Gemini API를 통합하여 구글 검색, 실시간 웹 분석 및 YouTube 영상 이해 탑재 |
| [@plannotator/pi-extension](https://pi.dev/packages/@plannotator/pi-extension) | 가동 중인 에이전트의 변경 계획안을 예쁜 로컬 브라우저 UI 상에서 직접 시각화하여 확인/승인 |
| [@juicesharp/rpiv-ask-user-question](https://pi.dev/packages/@juicesharp/rpiv-ask-user-question) | 애매모호한 요구 조건을 임의로 판단하지 않고 객관식/주관식 모달 문항을 띄워 사용자 동기화 |
| [pi-lens](https://pi.dev/packages/pi-lens) | 실시간 LSP 진단, 코드 포맷터, 타입 분석기, 수정 전 분석 안정성 가드 가동 |
| [@juicesharp/rpiv-todo](https://pi.dev/packages/@juicesharp/rpiv-todo) | 에이전트가 처리 중인 Task 목록을 /reload 시점 이후에도 영속성 있게 관리 |
| [pi-simplify](https://pi.dev/packages/pi-simplify) | 최근 편집 및 변경된 코드를 리팩토링 및 리비전 제안 피드백 가동 |
| [@juicesharp/rpiv-advisor](https://pi.dev/packages/@juicesharp/rpiv-advisor) | 행동 개시 직전 고차원 추론 모델의 2중 감사 피드백 확보 |
| [@juicesharp/rpiv-pi](https://pi.dev/packages/@juicesharp/rpiv-pi) | 리서치 -> 설계 -> 계획 -> 구현 -> 유효성 검증이라는 스킬 파이프라인 확립 |
| [@samfp/pi-memory](https://pi.dev/packages/@samfp/pi-memory) | 세션이 달라도 과거의 코딩 습관, 사용자 선호도 등을 계속 기억 및 반영 |
| [pi-btw](https://pi.dev/packages/pi-btw) | 메인 에이전트 가동에 지장을 주지 않고 병렬로 대화를 주고받을 수 있는 사이드 톡 (/btw) 지원 |
| [pi-docparser](https://pi.dev/packages/pi-docparser) | PDF, Office 파일, 다양한 시트 서식 로드 및 광학 문자 인식(OCR) 지원 |
| [pi-ollama-cloud](https://pi.dev/packages/pi-ollama-cloud?name=ollama) | 로컬 서버 사양이 무거워도 원격지 Ollama Cloud 서비스를 끌어와 동적 구동 |

> 💡 **Ollama Cloud 사용 시 세팅 가이드:**  
> `~/.pi/agent/auth.json` 파일을 열어 아래 서식과 같이 사용하시는 API Key를 명시해 주시면 에이전트 가동 시 원활하게 인식됩니다.
> ```json
> {
>   "anthropic": {
>     ...
>   },
>   "ollama-cloud": {
>     "type": "api_key",
>     "key": "YOUR_API_KEY"
>   }
> }
> ```

##### [pi 기본 사용법]
```bash
pi                  # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi --help           # 도움말 및 사용 가능 커맨드 파악
pi list             # 현재 설치 완료된 플러그인 에코시스템 목록 출력
```

#### 4.6. Open Code Review
Alibaba에서 개발한 AI 기반 오픈소스 코드 리뷰 자동화 도구입니다. 결정론적 엔지니어링 분석 기법과 LLM 에이전트의 강점을 하이브리드로 결합하여 코드 변경 사항의 컨텍스트를 깊이 있게 추적하고 리뷰 의견을 생성합니다.

##### [주요 특징]
* **엔지니어링 & 에이전트 하이브리드** — 정밀한 파일 필터링과 라인 매칭 기술로 위치 오류(Position drift)를 차단하고, LLM 에이전트가 코드의 시맨틱 영역을 입체적으로 탐색합니다.
* **풍부한 컨텍스트 인지** — 단순한 diff 분석에 머물지 않고 전체 소스코드 검색, 연관 파일 분석 등을 병행합니다.
* **CI/CD 통합 지원** — GitHub Actions, GitLab CI 등 빌드 파이프라인에 이식하여 풀 리퀘스트(PR) 발생 시 자동으로 코드 리뷰가 가동되도록 연동할 수 있습니다.

##### [사용을 위한 LLM 설정 (예: OpenAI)]
설치 후 사용하기 위해 LLM 엔드포인트 정보가 필요합니다. `ocr config` 명령어를 통해 환경을 구성합니다:
```bash
ocr config set llm.url "https://api.openai.com/v1"
ocr config set llm.auth_token "YOUR_API_KEY"
ocr config set llm.model "gpt-4o"
```

##### [ocr 기본 사용법]
```bash
ocr review --from main --to feature-branch   # base 브랜치와 head 브랜치 간 변경 사항 리뷰 실행
ocr config list                             # 현재 구성된 설정 목록 확인
```

---

_GitLab: https://gitlab.com/publicproj/install-sh_