README.md

# 필수 터미널 & 바이브 코딩 도구 모음 (`install-sh`)

단 한 줄의 명령어로 다양한 개발 생산성 CLI/TUI 도구와 AI 코딩 에이전트를 설치하고 관리할 수 있는 스크립트 저장소입니다.  
사용하시는 **운영체제(macOS/Linux 또는 Windows)**와 **카테고리 링크**를 클릭하여 바로 설치 명령어를 확인하세요.

> ⭐ **가장 자주 쓰는 핵심 필수 도구 11종만 한눈에 보려면 👉 [필수 핵심 도구 모음 (`NECESSARY.md`)](./NECESSARY.md) 문서를 확인하세요!**

---

## 🧭 운영체제 & 카테고리별 설치 가이드 바로가기

| 카테고리 | 포함 도구 | 🍎 macOS / 🐧 Linux (Bash) | 💻 Windows (PowerShell / CMD) |
| :--- | :--- | :---: | :---: |
| **📁 1. 터미널 관리 & 파일 유틸리티** | `tmux`, `rmux`, `Helix`, `superfile`, `dua` | **[👉 Linux / macOS 설치 및 사용법](./DOCS/UNIX-01-TERMINAL-FILE.md)** | **[👉 Windows 설치 및 사용법](./DOCS/WIN-01-TERMINAL-FILE.md)** |
| **🐳 2. 시스템 & 컨테이너 DevOps** | `bottom`, `all-smi`, `Docker`, `ctop`, `lazydocker` | **[👉 Linux / macOS 설치 및 사용법](./DOCS/UNIX-02-SYSTEM-DEVOPS.md)** | **[👉 Windows 설치 및 사용법](./DOCS/WIN-02-SYSTEM-DEVOPS.md)** |
| **🛠️ 3. 개발 유틸리티 & 에디터** | `lazygit`, `uv`, `VSCodium (codium)` | **[👉 Linux / macOS 설치 및 사용법](./DOCS/UNIX-03-DEV-UTILS.md)** | **[👉 Windows 설치 및 사용법](./DOCS/WIN-03-DEV-UTILS.md)** |
| **🤖 4. AI 개발 에이전트** | `Antigravity (agy)`, `Claude Code`, `Codex CLI`, `OpenCode`, `pi` | **[👉 Linux / macOS 설치 및 사용법](./DOCS/UNIX-04-AI-AGENTS.md)** | **[👉 Windows 설치 및 사용법](./DOCS/WIN-04-AI-AGENTS.md)** |
| **🧠 5. 바이브 코딩 도우미** | `graphify`, `Open Code Review (ocr)` | **[👉 Linux / macOS 설치 및 사용법](./DOCS/UNIX-05-VIBE-ASSISTANTS.md)** | **[👉 Windows 설치 및 사용법](./DOCS/WIN-05-VIBE-ASSISTANTS.md)** |

---

## 🗺️ 전체 문서 아키텍처

```mermaid
flowchart LR
    README["README.md<br/>(메인 네비게이션 허브)"]
    NEC["NECESSARY.md<br/>(필수 핵심 도구 요약본)"]
    README --> NEC

    subgraph UNIX["🍎 macOS / 🐧 Linux 가이드"]
        U1["UNIX-01-TERMINAL-FILE.md"]
        U2["UNIX-02-SYSTEM-DEVOPS.md"]
        U3["UNIX-03-DEV-UTILS.md"]
        U4["UNIX-04-AI-AGENTS.md"]
        U5["UNIX-05-VIBE-ASSISTANTS.md"]
    end

    subgraph WIN["💻 Windows 가이드"]
        W1["WIN-01-TERMINAL-FILE.md"]
        W2["WIN-02-SYSTEM-DEVOPS.md"]
        W3["WIN-03-DEV-UTILS.md"]
        W4["WIN-04-AI-AGENTS.md"]
        W5["WIN-05-VIBE-ASSISTANTS.md"]
    end

    README --> UNIX
    README --> WIN
```

---

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

### 📁 1. 터미널 관리 & 파일 유틸리티
> 🔗 **설치 가이드:** [🍎 macOS / 🐧 Linux](./DOCS/UNIX-01-TERMINAL-FILE.md) ｜ [💻 Windows](./DOCS/WIN-01-TERMINAL-FILE.md)

* **[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
> 🔗 **설치 가이드:** [🍎 macOS / 🐧 Linux](./DOCS/UNIX-02-SYSTEM-DEVOPS.md) ｜ [💻 Windows](./DOCS/WIN-02-SYSTEM-DEVOPS.md)

* **[bottom (btm)](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 가이드 제공)
* **[ctop](https://github.com/bcicen/ctop)** - 실시간 컨테이너 메트릭 및 자원 모니터링 TUI
* **[lazydocker](https://github.com/jesseduffield/lazydocker)** - 도커 컨테이너, 이미지, 볼륨을 시각적으로 제어하는 TUI

---

### 🛠️ 3. 개발 유틸리티 & 에디터
> 🔗 **설치 가이드:** [🍎 macOS / 🐧 Linux](./DOCS/UNIX-03-DEV-UTILS.md) ｜ [💻 Windows](./DOCS/WIN-03-DEV-UTILS.md)

* **[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 개발 에이전트 (AI Agents)
> 🔗 **설치 가이드:** [🍎 macOS / 🐧 Linux](./DOCS/UNIX-04-AI-AGENTS.md) ｜ [💻 Windows](./DOCS/WIN-04-AI-AGENTS.md)

* **[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 코딩 어시스턴트 및 추천 플러그인 패키지 15종 일괄 설치 도구

---

### 🧠 5. 바이브 코딩 도우미 (Vibe Coding Assistants)
> 🔗 **설치 가이드:** [🍎 macOS / 🐧 Linux](./DOCS/UNIX-05-VIBE-ASSISTANTS.md) ｜ [💻 Windows](./DOCS/WIN-05-VIBE-ASSISTANTS.md)

* **[graphify](https://github.com/astral-sh/uv)** - 코드베이스를 지식 그래프로 변환하여 에이전트의 컨텍스트 이해를 극대화하는 분석 도구
* **[Open Code Review (ocr)](https://github.com/alibaba/open-code-review)** - AI 기반의 오픈소스 코드 리뷰 자동화 도구

---

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