install-sh/NECESSARY.md

# 필수 핵심 터미널 도구 (Essential Terminal Tools)

개발 및 엔지니어링 작업에 반드시 필요한 핵심 도구만을 선별한 모음입니다. 단 한 줄의 명령어로 macOS, Linux, Windows 환경에서 설치하고 설정할 수 있습니다.

---

## 📂 핵심 지원 도구 목록

### 📁 1. 터미널 관리
* **[tmux](https://github.com/tmux/tmux)** - 강력한 터미널 멀티플렉서 (세션 보존 및 화면 분할, Windows는 psmux로 설치)

### 🐳 2. 시스템 & 컨테이너 DevOps
* **[bottom (btm)](https://github.com/ClementTsang/bottom)** - CPU, 메모리, 프로세스, 네트워크 등을 실시간 모니터링하는 TUI
* **[Docker](https://www.docker.com/)** - 컨테이너 가상화 플랫폼 (Linux 자동 설치 지원)
* **[ctop](https://github.com/bcicen/ctop)** - 실시간 컨테이너 메트릭 및 자원 사용량 모니터링 TUI

### 🛠️ 3. 개발 유틸리티
* **[lazygit](https://github.com/jesseduffield/lazygit)** - Git 버전 관리를 키보드로 능숙하게 제어하는 시각적 TUI
* **[uv](https://docs.astral.sh/uv/)** - 초고속 Rust 기반 Python 패키지 & 프로젝트 통합 관리자
* **[VSCodium (codium)](https://vscodium.com/)** - VS Code에서 파생되었으나 원격 측정(Telemetry)·추적기·독점 요소를 제거하고 최소한의 필요한 핵심 기능만 남긴 순수 오픈소스 코드 에디터

### 🤖 4. AI 개발 에이전트 & 도우미
* **[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
* **[graphify](https://github.com/astral-sh/uv)** - 코드베이스를 지식 그래프로 변환하여 에이전트의 컨텍스트 이해를 극대화하는 분석 도구

---

## 🚀 빠른 설치 가이드

### 🍎 MacOS / 🐧 Linux (Bash)

```bash
# 1. 터미널 관리
# tmux
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.sh?ref_type=heads" | bash

# 2. 시스템 & 컨테이너 DevOps
# bottom (btm)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash

# Docker (Linux 전용)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash

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

# 3. 개발 유틸리티
# lazygit
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.sh?ref_type=heads" | bash

# uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# VSCodium (codium)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.sh?ref_type=heads" | bash

# 4. AI 개발 에이전트 & 도우미
# Antigravity CLI (agy)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash

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

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

# graphify (uv 필요)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.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:**
    ```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
    ```

#### 2. 시스템 & 컨테이너 DevOps
* **bottom (btm):**
  * **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:**
    ```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
    ```

* **Docker:**
  [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 설치하거나, WSL2 내부에서 리눅스용 스크립트를 사용하세요.

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

#### 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:**
    ```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:**
    ```powershell
    irm https://astral.sh/uv/install.ps1 | iex
    ```

* **VSCodium (codium):**
  * **CMD:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-codium.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.ps1' -OutFile $t; & $t"
    ```
  * **PowerShell:**
    ```powershell
    $t="$env:TEMP\install-codium.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

#### 4. AI 개발 에이전트 & 도우미
* **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:**
    ```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:**
    ```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:**
    ```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
    ```

* **graphify (uv 필요):**
  * **CMD:**
    ```cmd
    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-graphify.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.ps1' -OutFile $t; & $t"
    ```
  * **PowerShell:**
    ```powershell
    $t="$env:TEMP\install-graphify.ps1"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.ps1' -OutFile $t; powershell -ExecutionPolicy Bypass -File $t
    ```

---

## 📖 필수 도구 핵심 사용법 및 팁

### 1. tmux
터미널 세션을 백그라운드에 보존하고 화면을 분할하여 사용할 수 있는 멀티플렉서입니다.
```bash
tmux                  # 새 세션 가동
tmux new -s <name>    # 이름 지정 세션 시작
tmux attach -t <name> # 특정 세션 다시 연결
tmux ls               # 가동 중인 세션 목록 보기
```

| 단축키 | 동작 |
| :--- | :--- |
| `Ctrl-a` | Prefix key (기본값) |
| `Prefix \|` | 화면 수평(좌우) 분할 |
| `Prefix -` | 화면 수직(위아래) 분할 |
| `Prefix h/j/k/l` | 패널 간 이동 (Vim 스타일) |
| `Prefix d` | 현재 세션에서 이탈 (Detach) |

> 💡 Windows에서는 Rust 기반 네이티브 멀티플렉서인 `psmux`가 설치되어 동일한 키바인딩과 설정을 지원합니다.

---

### 2. bottom (btm)
CPU, 메모리, 프로세스, 네트워크 및 디스크 사용량을 실시간으로 시각화하는 TUI 모니터입니다.
```bash
btm                   # 기본 모드로 실행
btm --basic           # 차트 그래프를 생략한 콤팩트 모드
```

| 단축키 | 동작 |
| :--- | :--- |
| `h / j / k / l` | 위젯/항목 간 이동 |
| `dd` | 선택한 프로세스 강제 종료 (Kill) |
| `e` | 선택한 프로세스 트리 펼치기/접기 |
| `q` | 종료 |

---

### 3. Docker & ctop
- **Docker**: 애플리케이션을 컨테이너 환경으로 패키징하고 배포하는 플랫폼입니다.
- **ctop**: 실행 중인 모든 컨테이너의 CPU, 메모리, 네트워크, I/O를 실시간 top 스타일로 보여주는 모니터입니다.

```bash
ctop                  # 실시간 컨테이너 모니터링 시작
```

| 단축키 | 동작 |
| :--- | :--- |
| `Enter` | 컨테이너 상세 메뉴 열기 (로그 보기, 정지, 재시작, 쉘 접속) |
| `l` | 선택한 컨테이너 로그 실시간 스트리밍 확인 |
| `s` | CPU / 메모리 등 메트릭 정렬 기준 변경 |
| `q` | 종료 |

---

### 4. lazygit
Git 명령어 없이도 키보드만으로 커밋, 브랜치 병합, 리베이스, 충돌 해결 등을 시각적으로 완벽하게 제어할 수 있는 TUI입니다.
```bash
lazygit               # 현재 git 저장소에서 실행
```

| 패널 번호 | 패널 구분 | 주요 기능 |
| :--- | :--- | :--- |
| `1` | Status | 저장소 상태 및 Git 정보 확인 |
| `2` | Files | 스테이징(`Space`), 커밋(`c`), 변경사항 확인 |
| `3` | Branches | 브랜치 전환(`Space`), 새 브랜치(`n`), 병합(`M`) |
| `4` | Commits | 커밋 로그 확인, 체리픽(`c`), 리셋/스쿼시 |
| `5` | Stash | 스태시 저장 및 복원 |

---

### 5. uv
Rust로 작성된 차세대 초고속 Python 패키지/프로젝트 관리자입니다. `pip`, `poetry`, `pyenv`의 기능을 한 도구로 대체합니다.
```bash
uv venv                          # 초고속 가상환경(.venv) 생성
uv pip install <package>         # 초고속 패키지 설치
uv run <script.py>               # 가상환경 격리 실행
uv tool install <cli-tool>       # 독립된 CLI 도구 글로벌 설치
```

---

### 6. VSCodium (codium)
VS Code에서 출발했으나 원격 측정(Telemetry)·추적기·독점 요소를 모두 걷어내고 **개발에 꼭 필요한 최소한의 핵심 기능만 남긴 순수 오픈소스 코드 에디터**입니다.
```bash
codium .                                # 현재 디렉토리를 VSCodium으로 열기
codium <file>                           # 특정 파일 바로 열기
codium --install-extension <ext-id>     # Open VSX 확장 플러그인 설치
```

---

### 7. AI 개발 에이전트 (Antigravity, Claude, Codex)

#### 7.1. Antigravity CLI (agy)
Google DeepMind의 Antigravity 플랫폼 터미널 코딩 에이전트입니다.
```bash
agy                   # 대화형 코딩 세션 시작
agy -p "작업 내용"    # 단발성 프롬프트 실행
```

#### 7.2. Claude Code
Anthropic의 공식 터미널 기반 대화형 코딩 어시스턴트입니다.
```bash
claude                # 대화형 코딩 세션 시작
claude -p "작업 내용" # 단발성 프롬프트 실행
```

#### 7.3. Codex CLI
OpenAI의 공식 터미널 기반 로컬 대화형 코딩 에이전트입니다.
```bash
codex auth            # 인증 로그인
codex                 # 대화형 코딩 세션 시작
codex -p "작업 내용"  # 단발성 빌드/수정 지시
```

---

### 8. graphify
코드베이스와 문서를 지식 그래프(Knowledge Graph)로 인덱싱하여 복잡한 프로젝트 구조를 빠르게 분석하고 질문에 정밀하게 답하도록 돕는 도구입니다.
```bash
graphify .                                              # 현재 프로젝트 그래프 빌드/갱신
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘"   # 지식 그래프 기반 자연어 질의
graphify path "AuthManager" "DatabasePool"              # 두 심볼 간의 연관 호출 관계 경로 추적
graphify explain "WorkerProcess"                        # 특정 클래스/함수 노드의 상세 정보 확인
graphify update .                                       # AST 기반 초고속 증분 업데이트 (무비용)
```