publicproj/install-sh
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README 문서를 OS별/카테고리별 하위 문서(DOCS/)로 분리 및 인덱스 허브 개편

Browse Source
This commit is contained in:
mcchae committed 2026-11-07 13:33:45 +09:00
1 parent 687ebb0e0a
commit 53ca0fefa9
13 files changed
+1376 -779
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

DOCS/UNIX-01-TERMINAL-FILE.md
+182
View File
@@ -0,0 +1,182 @@
# 📁 [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)
DOCS/UNIX-02-SYSTEM-DEVOPS.md
+142
View File
@@ -0,0 +1,142 @@
# 🐳 [macOS / Linux] 2. 시스템 & 컨테이너 DevOps
[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-02-SYSTEM-DEVOPS.md)
---
## ⚡ 빠른 원클릭 설치 (Bash)
```bash
# 2.1. bottom (CPU/메모리/네트워크 실시간 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash
# 2.2. all-smi (이종 GPU/NPU 가속기 통합 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.sh?ref_type=heads" | bash
# 2.3. Docker (Linux 전용 자동 설치)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash
# 2.4. ctop (실시간 컨테이너 메트릭 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.sh?ref_type=heads" | bash
# 2.5. lazydocker (도커 컨테이너·이미지·볼륨 통합 제어 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.sh?ref_type=heads" | bash
```
---
## 📖 도구별 상세 사용법 및 단축키
### 2.1. [bottom (btm)](https://github.com/ClementTsang/bottom)
기존의 `top`이나 `htop`을 완벽하게 대체하는 화려하고 가벼운 호스트 시스템 리소스 모니터링 TUI 도구입니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **풀 그래픽 차트** — CPU 코어별 사용률, RAM/Swap, 네트워크 흐름, 디스크 I/O 실시간 그래프화
* **정교한 프로세스 제어** — 프로세스를 정렬하고 직접 제어 및 강제 종료 가능
```bash
btm # 실행 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `F1` ~ `F5` | 메트릭 모니터링 탭 이동 |
| `↑` `↓` | 프로세스 목록 선택 이동 |
| `k` / `dd` | 선택한 대상 프로세스 강제 종료 (Kill) |
| `/` | 실시간 프로세스명 검색 필터링 |
---
### 2.2. [all-smi](https://github.com/lablup/all-smi)
Lablup에서 개발한 이종(Heterogeneous) 가속기 및 GPU/NPU 자원 통합 모니터링 CLI/TUI 도구입니다. `nvidia-smi`를 대체/확장하여 다양한 AI 가속기 및 클러스터 노드 관제를 지원합니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **이종 가속기 지원** — 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](https://www.docker.com/)
컨테이너 기반 애플리케이션 가상화 플랫폼입니다.
* **설치 명령 (Linux 전용):**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash
```
```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/) 설치를 권장합니다.
> * **Linux:** 설치 완료 후 스크립트가 로그인된 유저를 자동으로 `docker` 권한 그룹에 할당합니다. 터미널 세션을 재로그인하시면 `sudo` 없이 편하게 제어하실 수 있습니다.
---
### 2.4. [ctop](https://github.com/bcicen/ctop) & 2.5. [lazydocker](https://github.com/jesseduffield/lazydocker)
가동 중인 컨테이너들을 효율적으로 모니터링하고 관리할 수 있도록 지원하는 특화 TUI 듀오입니다.
| 도구명 | 특징 및 주요 권장 환경 |
| :--- | :--- |
| **ctop** | 실시간 리소스 메트릭(CPU, RAM, 네트워크 트래픽 등) 모니터링에 고도로 특화됨 |
| **lazydocker** | 컨테이너 상태 조회는 물론이고 시작, 정지, 재시작, 로그 보기, 내부 셸 진입 등 전반적인 컨테이너 수명 주기 관리에 적합함 |
#### [ctop 설치 및 사용법]
```bash
# 설치
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.sh?ref_type=heads" | bash
# 실행
ctop
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `↑` `↓` | 컨테이너 리스트 이동 |
| `l` | 선택된 컨테이너의 실시간 로그 화면 로드 |
| `a` | 숨겨진 비활성 컨테이너까지 전부 표시 |
| `f` | 특정 컨테이너 이름 검색 필터링 |
| `S` / `R` | 선택된 컨테이너 정지 / 즉시 재시작 |
#### [lazydocker 설치 및 사용법]
```bash
# 설치
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.sh?ref_type=heads" | bash
# 실행
lazydocker
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↑` `↓` | 목록 패널 탐색 |
| `Enter` | 컨테이너 상세 로그 및 자원 소비 통계 보기 |
| `s` / `r` | 컨테이너 인스턴스 정지 (Stop) / 재시작 (Restart) |
| `e` | 컨테이너 내부 터미널 즉시 실행 진입 (Exec) |
| `x` | 컨테이너 강제 파괴 및 제거 (Remove) |
| `[` `]` | 탭 및 패널 간 수평 포커스 이동 |
---
[⬅️ 이전: 1. 터미널 관리 & 파일 유틸리티](./UNIX-01-TERMINAL-FILE.md) | [🏠 메인 README](../README.md) | [다음: 3. 개발 유틸리티 ➡️](./UNIX-03-DEV-UTILS.md)
DOCS/UNIX-03-DEV-UTILS.md
+94
View File
@@ -0,0 +1,94 @@
# 🛠️ [macOS / Linux] 3. 개발 유틸리티 & 코드 에디터
[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-03-DEV-UTILS.md)
---
## ⚡ 빠른 원클릭 설치 (Bash)
```bash
# 3.1. lazygit (Git 버전 관리 시각적 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.sh?ref_type=heads" | bash
# 3.2. uv (Rust 기반 초고속 Python 패키지 & 프로젝트 관리자)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 3.3. VSCodium (VS Code에서 불필요한 요소를 덜어낸 순수 오픈소스 코드 에디터)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.sh?ref_type=heads" | bash
```
---
## 📖 도구별 상세 사용법 및 단축키
### 3.1. [lazygit](https://github.com/jesseduffield/lazygit)
복잡하고 가끔은 위험할 수 있는 Git CLI 명령어들을 직관적인 단축키와 패널 구성을 통해 신속하고 깔끔하게 제어하도록 도와주는 최고의 Git TUI 도구입니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **직관적인 변경사항 추적** — 수정된 파일들의 코드 변경점을 실시간 visual diff로 파악
* **신속한 형상 관리** — Stage, Unstage, Commit, Push, Pull, Branch 스왑, Stash 작업을 터치리스로 신속 처리
* **Rebase 지원** — 충돌 해결 및 Interactive Rebase(스쿼시 등)의 복잡성을 혁신적으로 단축
```bash
lazygit # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↓` `↑` `→` `←` | 파일 / 스테이지 / 커밋 / 브랜치 패널 포커스 이동 |
| `Space` | 현재 선택 파일 Stage / Unstage 전환 |
| `c` | 커밋 메시지 작성 윈도우 팝업 |
| `P` / `p` | 원격 저장소에 Push / Pull 요청 실행 |
| `?` | 전체 단축키 치트 시트 일람 로드 |
---
### 3.2. [uv](https://docs.astral.sh/uv/)
Rust로 작성된 초고속 차세대 Python 패키지 및 프로젝트 통합 관리 도구입니다. 기존의 `pip`, `pip-tools`, `virtualenv`, `pyenv`, `pipx`, `poetry`를 단 하나의 단일 바이너리로 완벽히 대체하며 10~100배 빠른 속도를 제공합니다.
* **설치 명령:**
```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
> ```
```bash
uv venv # 현재 폴더에 가상환경(.venv) 초고속 생성
uv pip install <package> # 가상환경에 패키지 설치
uv run <script.py> # 가상환경을 자동 구성하여 스크립트 실행
uv tool install <cli-tool> # CLI 도구를 격리된 환경에 글로벌 설치
```
---
### 3.3. [VSCodium (codium)](https://vscodium.com/)
Microsoft의 **Visual Studio Code(VS Code) 오픈소스 코드베이스에서 출발**했으나, Microsoft의 독점 라이선스 래퍼·원격 측정(Telemetry)·사용자 추적(Tracking) 및 불필요한 부가 요소를 완전히 걷어내고 **개발에 꼭 필요한 최소한의 핵심 에디터 기능만 남긴 순수 오픈소스(MIT 라이선스) 코드 에디터**입니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **VS Code 기반의 친숙함과 완벽한 호환성** — VS Code와 동일한 에디터 코어, 단축키, UI, 디버거, Git 통합 환경을 그대로 제공
* **최소한의 핵심 요소만 탑재 (Zero Telemetry)** — 백그라운드 데이터 수집이나 불필요한 독점 서비스 연동 없이 가볍고 깨끗하게 동작
* **오픈소스 마켓플레이스(Open VSX) 기본 연동** — 독점 마켓플레이스 대신 개방형 확장 생태계인 [Open VSX Registry](https://open-vsx.org/)를 기본 사용하여 필요한 확장 기능만 깔끔하게 설치 가능
```bash
codium . # 현재 디렉토리를 VSCodium으로 열기
codium <file> # 특정 파일 바로 열기
codium --install-extension <ext-id> # 확장 플러그인 설치
codium --list-extensions # 설치된 확장 플러그인 목록 확인
```
---
[⬅️ 이전: 2. 시스템 & 컨테이너 DevOps](./UNIX-02-SYSTEM-DEVOPS.md) | [🏠 메인 README](../README.md) | [다음: 4. AI 개발 에이전트 ➡️](./UNIX-04-AI-AGENTS.md)
DOCS/UNIX-04-AI-AGENTS.md
+143
View File
@@ -0,0 +1,143 @@
# 🤖 [macOS / Linux] 4. AI 개발 에이전트 (AI Agents)
[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-04-AI-AGENTS.md)
---
## ⚡ 빠른 원클릭 설치 (Bash)
```bash
# 4.1. Antigravity CLI (agy)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash
# 4.2. Claude Code
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
# 4.3. Codex CLI
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
# 4.4. OpenCode
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash
# 4.5. pi (Pi Coding Agent + 추천 패키지 15종 일괄 설치)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
```
---
## 📖 도구별 상세 사용법 및 팁
### 4.1. [Antigravity CLI (agy)](https://antigravity.google)
Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **로컬 터미널 밀착 코딩** — 별도의 무거운 데스크톱 GUI 없이 터미널 내부에서 완벽한 페어 프로그래밍 실현
* **보안 Google 계정 연동** — 첫 가동 시 Google Sign-In 보안 흐름이 브라우저와 클라이언트 단에서 연동 가동됨
* **유연한 자동화** — CI/CD 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원
```bash
agy # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항" # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help # 도움말 및 명령어 명세 로드
```
---
### 4.2. [Claude Code](https://code.claude.com/)
Anthropic사에서 개발한 공식 터미널 기반 AI 개발 어시스턴트 툴킷입니다. npm이 깔려있지 않은 시스템에서도 curl 공식 네이티브 설치 방식을 사용하여 즉시 CLI 코딩 환경에 접목할 수 있습니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **고속 컨텍스트 추론** — Anthropic Claude 고성능 추론 엔진을 터미널 내에서 바로 가동
* **네이티브 실행 제어** — 시스템 아키텍처 환경과 로컬 파일 구조를 깊이 이해하고 즉시 빌드 및 리서치 수행
* **안전성 확보** — 강력한 로컬 샌드박스 정책 및 권한 승인 모드를 통해 안전한 자동 코딩 보장
```bash
claude # 대화형 코딩 세션 시작 (OAuth 로그인 연동)
claude -p "질문/작업" # 터미널 창을 열지 않고 즉시 지시 수행 및 결과 출력 (단발 실행)
claude --help # 도움말 및 사용법 로드
```
---
### 4.3. [Codex CLI](https://developers.openai.com/codex/cli)
OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다. Rust 기반으로 제작되어 높은 성능을 자랑하며, npm 없이도 단일 실행 공식 인스톨러 방식을 활용해 네이티브하게 작동합니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **강력한 시스템 통합** — 터미널 로컬 환경에서 사용자의 지시 하에 파일 편집, 아키텍처 리서치 및 CLI 빌드 실행 지원
* **다양한 모델 스왑** — 세션 내에서 GPT-5.4, GPT-5.3-Codex 등으로 자유롭게 두뇌 변경 및 추론 조작 지원
* **멀티모달 시각 분석** — 스크린샷이나 와이어프레임 설계도를 입력받아 UI 코드를 고속으로 구현 및 피드백
```bash
codex auth # OpenAI ChatGPT 또는 API 계정 연동 로그인
codex # 대화형 코딩 TUI 세션 시작
codex -p "작업명령" # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
```
---
### 4.4. [OpenCode](https://opencode.ai/)
터미널, IDE, 데스크톱 환경을 아우르는 오픈소스 AI 코딩 에이전트 CLI입니다. 특정 AI 프로바이더에 종속되지 않고 OpenAI, Anthropic, Google(Gemini)뿐 아니라 Ollama 등 로컬 모델을 포함한 75개 이상의 LLM 프로바이더를 자유롭게 연결하여 코드베이스 분석, 파일 편집, 터미널 명령 실행 등을 수행합니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash
```
```bash
opencode # 대화형 코딩 TUI 세션 시작
opencode auth login # AI 모델 프로바이더 계정 및 API 키 연동
opencode --help # 도움말 및 사용 가능 옵션 확인
```
---
### 4.5. [Pi Coding Agent (pi)](https://pi.dev/)
CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 `install-pi.sh` 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
```
#### [일괄 설치되는 추천 패키지 리스트]
| 패키지 | 설명 |
| :--- | :--- |
| [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 서비스를 끌어와 동적 구동 |
```bash
pi # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi --help # 도움말 및 사용 가능 커맨드 파악
pi list # 현재 설치 완료된 플러그인 에코시스템 목록 출력
```
---
[⬅️ 이전: 3. 개발 유틸리티](./UNIX-03-DEV-UTILS.md) | [🏠 메인 README](../README.md) | [다음: 5. 바이브 코딩 도우미 ➡️](./UNIX-05-VIBE-ASSISTANTS.md)
DOCS/UNIX-05-VIBE-ASSISTANTS.md
+73
View File
@@ -0,0 +1,73 @@
# 🧠 [macOS / Linux] 5. 바이브 코딩 도우미 (Vibe Coding Assistants)
[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-05-VIBE-ASSISTANTS.md)
---
## ⚡ 빠른 원클릭 설치 (Bash)
```bash
# 5.1. graphify (코드베이스 지식 그래프 분석기 — 사전 요구사항: uv)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.sh?ref_type=heads" | bash
# 5.2. Open Code Review (ocr — AI 기반 오픈소스 코드 리뷰 자동화 도구)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.sh?ref_type=heads" | bash
```
---
## 📖 도구별 상세 사용법 및 팁
### 5.1. [graphify](https://github.com/astral-sh/uv)
코드베이스, 문서, 아키텍처를 지식 그래프(Knowledge Graph)로 구조화하여 AI 에이전트가 방대한 코드베이스를 단번에 파악하고 질문에 정밀하게 답변할 수 있도록 돕는 지식 그래프 분석 엔진입니다. Antigravity, Claude Code, Codex, OpenCode 등 다양한 바이브 코딩 에이전트와 매끄럽게 연동되며 Gemini MCP 서버를 지원합니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.sh?ref_type=heads" | bash
```
> 💡 **사전 요구사항:** Python 패키지 관리자 `uv`가 먼저 설치되어 있어야 합니다. (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
* **주요 특징:**
* **다차원 지식 그래프 구축** — AST 구문 분석과 시맨틱 요약을 통해 함수, 클래스, 모듈 간의 호출 및 상속 관계를 시각적 그래프로 인덱싱
* **자연어 질의(Query) & 경로 탐색(Path)** — 코드베이스에 대한 질문을 던지면 관련 서브그래프를 추출하고, 두 심볼 간의 최단 호출 경로 추적
* **원클릭 에이전트 연동** — `graphify antigravity/claude/codex/opencode install` 명령어로 에이전트 규칙 및 MCP 환경 자동 셋업
* **Gemini MCP 연동** — `~/.gemini/antigravity/mcp_config.json`을 통해 실시간 MCP 서비스로 연동
```bash
graphify . # 현재 디렉토리의 코드베이스 그래프 빌드/갱신
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘" # 지식 그래프 기반 자연어 질의
graphify path "AuthManager" "DatabasePool" # 두 심볼 간의 연관 호출 관계 경로 추적
graphify explain "WorkerProcess" # 특정 클래스/함수 노드의 상세 정보 확인
graphify update . # AST 기반 초고속 증분 업데이트 (무비용)
```
---
### 5.2. [Open Code Review (ocr)](https://github.com/alibaba/open-code-review)
Alibaba에서 개발한 AI 기반 오픈소스 코드 리뷰 자동화 도구입니다. 결정론적 엔지니어링 분석 기법과 LLM 에이전트의 강점을 하이브리드로 결합하여 코드 변경 사항의 컨텍스트를 깊이 있게 추적하고 리뷰 의견을 생성합니다.
* **설치 명령:**
```bash
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.sh?ref_type=heads" | bash
```
* **주요 특징:**
* **엔지니어링 & 에이전트 하이브리드** — 정밀한 파일 필터링과 라인 매칭 기술로 위치 오류(Position drift)를 차단하고, LLM 에이전트가 코드의 시맨틱 영역을 입체적으로 탐색
* **풍부한 컨텍스트 인지** — 단순한 diff 분석에 머물지 않고 전체 소스코드 검색, 연관 파일 분석 등을 병행
* **CI/CD 통합 지원** — GitHub Actions, GitLab CI 등 빌드 파이프라인에 이식하여 PR 발생 시 자동 코드 리뷰 연동 가능
#### [사용을 위한 LLM 설정 (예: OpenAI)]
```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 # 현재 구성된 설정 목록 확인
```
---
[⬅️ 이전: 4. AI 개발 에이전트](./UNIX-04-AI-AGENTS.md) | [🏠 메인 README로 돌아가기](../README.md)
DOCS/WIN-01-TERMINAL-FILE.md
+165
View File
@@ -0,0 +1,165 @@
# 📁 [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)
DOCS/WIN-02-SYSTEM-DEVOPS.md
+127
View File
@@ -0,0 +1,127 @@
# 🐳 [Windows] 2. 시스템 & 컨테이너 DevOps
[⬅️ 메인 README로 돌아가기](../README.md) | [🍎 macOS / 🐧 Linux 가이드 보기](./UNIX-02-SYSTEM-DEVOPS.md)
---
## ⚡ 빠른 원클릭 설치 (PowerShell / CMD)
### 2.1. 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
```
### 2.2. 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 창에서 실행:**
```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
```
### 2.3. Docker
* Windows에서는 [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 설치하거나, WSL2 내부에서 리눅스용 `install-docker.sh`를 실행하세요.
### 2.4. 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
```
### 2.5. 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 창에서 실행:**
```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
```
---
## 📖 도구별 상세 사용법 및 단축키
### 2.1. [bottom (btm)](https://github.com/ClementTsang/bottom)
CPU 코어별 사용률, RAM/Swap, 네트워크 흐름, 디스크 I/O를 실시간 그래프로 보여주는 시스템 리소스 모니터링 TUI 도구입니다.
```powershell
btm # 실행 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `F1` ~ `F5` | 메트릭 모니터링 탭 이동 |
| `↑` `↓` | 프로세스 목록 선택 이동 |
| `k` / `dd` | 선택한 대상 프로세스 강제 종료 (Kill) |
| `/` | 실시간 프로세스명 검색 필터링 |
---
### 2.2. [all-smi](https://github.com/lablup/all-smi)
Lablup에서 개발한 이종(Heterogeneous) 가속기 및 GPU/NPU 자원 통합 모니터링 CLI/TUI 도구입니다.
```powershell
all-smi # 인터랙티브 모니터링 TUI 세션 시작
all-smi --help # 도움말 및 사용 가능 옵션 확인
```
---
### 2.3. [Docker](https://www.docker.com/)
컨테이너 기반 애플리케이션 가상화 플랫폼입니다.
```powershell
docker run hello-world # 동작 유효성 테스트
docker ps # 가동 중인 컨테이너 목록
docker compose up -d # 멀티 컨테이너 환경 백그라운드 구동
```
---
### 2.4. [ctop](https://github.com/bcicen/ctop) & 2.5. [lazydocker](https://github.com/jesseduffield/lazydocker)
#### [ctop 사용법]
```powershell
ctop # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `↑` `↓` | 컨테이너 리스트 이동 |
| `l` | 선택된 컨테이너의 실시간 로그 화면 로드 |
| `a` | 숨겨진 비활성 컨테이너까지 전부 표시 |
| `S` / `R` | 선택된 컨테이너 정지 / 즉시 재시작 |
#### [lazydocker 사용법]
```powershell
lazydocker # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↑` `↓` | 목록 패널 탐색 |
| `Enter` | 컨테이너 상세 로그 및 자원 소비 통계 보기 |
| `s` / `r` | 컨테이너 인스턴스 정지 (Stop) / 재시작 (Restart) |
| `e` | 컨테이너 내부 터미널 즉시 실행 진입 (Exec) |
| `x` | 컨테이너 강제 파괴 및 제거 (Remove) |
---
[⬅️ 이전: 1. 터미널 관리 & 파일 유틸리티](./WIN-01-TERMINAL-FILE.md) | [🏠 메인 README](../README.md) | [다음: 3. 개발 유틸리티 ➡️](./WIN-03-DEV-UTILS.md)
DOCS/WIN-03-DEV-UTILS.md
+93
View File
@@ -0,0 +1,93 @@
# 🛠️ [Windows] 3. 개발 유틸리티 & 코드 에디터
[⬅️ 메인 README로 돌아가기](../README.md) | [🍎 macOS / 🐧 Linux 가이드 보기](./UNIX-03-DEV-UTILS.md)
---
## ⚡ 빠른 원클릭 설치 (PowerShell / CMD)
### 3.1. 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
```
### 3.2. 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
```
> 💡 설치 후 `$env:USERPROFILE\.local\bin`이 PATH에 없으면 추가하세요:
> ```powershell
> [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User')
> ```
### 3.3. 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
```
---
## 📖 도구별 상세 사용법 및 단축키
### 3.1. [lazygit](https://github.com/jesseduffield/lazygit)
Git CLI 명령어들을 직관적인 단축키와 패널 구성을 통해 신속하고 깔끔하게 제어하도록 도와주는 Git TUI 도구입니다. (Windows에 Git이 없는 경우 스크립트가 자동으로 `PortableGit`까지 함께 구성합니다.)
```powershell
lazygit # 가동 명령어
```
| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↓` `↑` `→` `←` | 파일 / 스테이지 / 커밋 / 브랜치 패널 포커스 이동 |
| `Space` | 현재 선택 파일 Stage / Unstage 전환 |
| `c` | 커밋 메시지 작성 윈도우 팝업 |
| `P` / `p` | 원격 저장소에 Push / Pull 요청 실행 |
| `?` | 전체 단축키 치트 시트 일람 로드 |
---
### 3.2. [uv](https://docs.astral.sh/uv/)
Rust로 작성된 초고속 차세대 Python 패키지 및 프로젝트 통합 관리 도구입니다.
```powershell
uv venv # 현재 폴더에 가상환경(.venv) 초고속 생성
uv pip install <package> # 가상환경에 패키지 설치
uv run <script.py> # 가상환경을 자동 구성하여 스크립트 실행
uv tool install <cli-tool> # CLI 도구를 격리된 환경에 글로벌 설치
```
---
### 3.3. [VSCodium (codium)](https://vscodium.com/)
Microsoft의 **Visual Studio Code(VS Code) 오픈소스 코드베이스에서 출발**했으나, Microsoft의 독점 라이선스 래퍼·원격 측정(Telemetry)·사용자 추적(Tracking) 및 불필요한 부가 요소를 완전히 걷어내고 **개발에 꼭 필요한 최소한의 핵심 에디터 기능만 남긴 순수 오픈소스(MIT 라이선스) 코드 에디터**입니다.
* **VS Code 기반의 친숙함과 완벽한 호환성** — VS Code와 동일한 에디터 코어, 단축키, UI, 디버거, Git 통합 환경을 그대로 제공
* **최소한의 핵심 요소만 탑재 (Zero Telemetry)** — 백그라운드 데이터 수집이나 불필요한 독점 서비스 연동 없이 가볍고 깨끗하게 동작
* **오픈소스 마켓플레이스(Open VSX) 기본 연동** — 개방형 확장 생태계인 [Open VSX Registry](https://open-vsx.org/)를 기본 사용하여 필요한 확장 기능만 깔끔하게 설치 가능
```powershell
codium . # 현재 디렉토리를 VSCodium으로 열기
codium <file> # 특정 파일 바로 열기
codium --install-extension <ext-id> # 확장 플러그인 설치
codium --list-extensions # 설치된 확장 플러그인 목록 확인
```
---
[⬅️ 이전: 2. 시스템 & 컨테이너 DevOps](./WIN-02-SYSTEM-DEVOPS.md) | [🏠 메인 README](../README.md) | [다음: 4. AI 개발 에이전트 ➡️](./WIN-04-AI-AGENTS.md)
DOCS/WIN-04-AI-AGENTS.md
+118
View File
@@ -0,0 +1,118 @@
# 🤖 [Windows] 4. AI 개발 에이전트 (AI Agents)
[⬅️ 메인 README로 돌아가기](../README.md) | [🍎 macOS / 🐧 Linux 가이드 보기](./UNIX-04-AI-AGENTS.md)
---
## ⚡ 빠른 원클릭 설치 (PowerShell / CMD)
### 4.1. 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
```
### 4.2. 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
```
### 4.3. 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
```
### 4.4. 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 창에서 실행:**
```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
```
### 4.5. pi (Pi Coding Agent + 추천 패키지 15종)
* **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 창에서 실행:**
```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
```
---
## 📖 도구별 상세 사용법 및 팁
### 4.1. [Antigravity CLI (agy)](https://antigravity.google)
Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다.
```powershell
agy # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항" # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help # 도움말 및 명령어 명세 로드
```
---
### 4.2. [Claude Code](https://code.claude.com/)
Anthropic사에서 개발한 공식 터미널 기반 AI 개발 어시스턴트입니다.
```powershell
claude # 대화형 코딩 세션 시작 (OAuth 로그인 연동)
claude -p "질문/작업" # 즉시 지시 수행 및 결과 출력 (단발 실행)
claude --help # 도움말 및 사용법 로드
```
---
### 4.3. [Codex CLI](https://developers.openai.com/codex/cli)
OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다.
```powershell
codex auth # OpenAI ChatGPT 또는 API 계정 연동 로그인
codex # 대화형 코딩 TUI 세션 시작
codex -p "작업명령" # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
```
---
### 4.4. [OpenCode](https://opencode.ai/)
75개 이상의 LLM 프로바이더를 지원하는 오픈소스 터미널 코딩 에이전트입니다.
```powershell
opencode # 대화형 코딩 TUI 세션 시작
opencode auth login # AI 모델 프로바이더 계정 및 API 키 연동
opencode --help # 도움말 및 사용 가능 옵션 확인
```
---
### 4.5. [Pi Coding Agent (pi)](https://pi.dev/)
CLI 기반 AI 코딩 파트너와 핵심 플러그인 에코시스템 15종을 일괄 설치합니다.
```powershell
pi # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi list # 현재 설치 완료된 플러그인 목록 출력
```
---
[⬅️ 이전: 3. 개발 유틸리티](./WIN-03-DEV-UTILS.md) | [🏠 메인 README](../README.md) | [다음: 5. 바이브 코딩 도우미 ➡️](./WIN-05-VIBE-ASSISTANTS.md)
DOCS/WIN-05-VIBE-ASSISTANTS.md
+65
View File
@@ -0,0 +1,65 @@
# 🧠 [Windows] 5. 바이브 코딩 도우미 (Vibe Coding Assistants)
[⬅️ 메인 README로 돌아가기](../README.md) | [🍎 macOS / 🐧 Linux 가이드 보기](./UNIX-05-VIBE-ASSISTANTS.md)
---
## ⚡ 빠른 원클릭 설치 (PowerShell / CMD)
### 5.1. 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
```
> 💡 **사전 요구사항:** Python 패키지 관리자 `uv`가 먼저 설치되어 있어야 합니다. (`irm https://astral.sh/uv/install.ps1 | iex`)
### 5.2. 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 창에서 실행:**
```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
```
---
## 📖 도구별 상세 사용법 및 팁
### 5.1. [graphify](https://github.com/astral-sh/uv)
코드베이스, 문서, 아키텍처를 지식 그래프(Knowledge Graph)로 구조화하여 AI 에이전트가 방대한 코드베이스를 단번에 파악하고 질문에 정밀하게 답변할 수 있도록 돕는 지식 그래프 분석 엔진입니다. Antigravity, Claude Code, Codex, OpenCode 등 다양한 바이브 코딩 에이전트와 연동되며 `$env:USERPROFILE\.gemini\antigravity\mcp_config.json`에 Gemini MCP 설정을 자동 구성합니다.
```powershell
graphify . # 현재 디렉토리의 코드베이스 그래프 빌드/갱신
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘" # 지식 그래프 기반 자연어 질의
graphify path "AuthManager" "DatabasePool" # 두 심볼 간의 연관 호출 관계 경로 추적
graphify explain "WorkerProcess" # 특정 클래스/함수 노드의 상세 정보 확인
graphify update . # AST 기반 초고속 증분 업데이트 (무비용)
```
---
### 5.2. [Open Code Review (ocr)](https://github.com/alibaba/open-code-review)
Alibaba에서 개발한 AI 기반 오픈소스 코드 리뷰 자동화 도구입니다.
#### [사용을 위한 LLM 설정 (예: OpenAI)]
```powershell
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 기본 사용법]
```powershell
ocr review --from main --to feature-branch # base 브랜치와 head 브랜치 간 변경 사항 리뷰 실행
ocr config list # 현재 구성된 설정 목록 확인
```
---
[⬅️ 이전: 4. AI 개발 에이전트](./WIN-04-AI-AGENTS.md) | [🏠 메인 README로 돌아가기](../README.md)