diff --git a/DOCS/UNIX-01-TERMINAL-FILE.md b/DOCS/UNIX-01-TERMINAL-FILE.md new file mode 100644 index 0000000..9836c6b --- /dev/null +++ b/DOCS/UNIX-01-TERMINAL-FILE.md @@ -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 # 이름 μ§€μ • μ„Έμ…˜ μ‹œμž‘ +tmux attach -t # νŠΉμ • μ„Έμ…˜ λ‹€μ‹œ μ—°κ²° +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 # μ‹€ν–‰ λͺ…λ Ήμ–΄ +``` + +| 단좕킀 | λ™μž‘ | +| :--- | :--- | +| `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) diff --git a/DOCS/UNIX-02-SYSTEM-DEVOPS.md b/DOCS/UNIX-02-SYSTEM-DEVOPS.md new file mode 100644 index 0000000..8ccb437 --- /dev/null +++ b/DOCS/UNIX-02-SYSTEM-DEVOPS.md @@ -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 . # 둜컬 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) diff --git a/DOCS/UNIX-03-DEV-UTILS.md b/DOCS/UNIX-03-DEV-UTILS.md new file mode 100644 index 0000000..195f4c4 --- /dev/null +++ b/DOCS/UNIX-03-DEV-UTILS.md @@ -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 # κ°€μƒν™˜κ²½μ— νŒ¨ν‚€μ§€ μ„€μΉ˜ +uv run # κ°€μƒν™˜κ²½μ„ μžλ™ κ΅¬μ„±ν•˜μ—¬ 슀크립트 μ‹€ν–‰ +uv tool install # 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 # νŠΉμ • 파일 λ°”λ‘œ μ—΄κΈ° +codium --install-extension # ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ μ„€μΉ˜ +codium --list-extensions # μ„€μΉ˜λœ ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ λͺ©λ‘ 확인 +``` + +--- + +[⬅️ 이전: 2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps](./UNIX-02-SYSTEM-DEVOPS.md) | [🏠 메인 README](../README.md) | [λ‹€μŒ: 4. AI 개발 μ—μ΄μ „νŠΈ ➑️](./UNIX-04-AI-AGENTS.md) diff --git a/DOCS/UNIX-04-AI-AGENTS.md b/DOCS/UNIX-04-AI-AGENTS.md new file mode 100644 index 0000000..65c2178 --- /dev/null +++ b/DOCS/UNIX-04-AI-AGENTS.md @@ -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) diff --git a/DOCS/UNIX-05-VIBE-ASSISTANTS.md b/DOCS/UNIX-05-VIBE-ASSISTANTS.md new file mode 100644 index 0000000..7adaba8 --- /dev/null +++ b/DOCS/UNIX-05-VIBE-ASSISTANTS.md @@ -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) diff --git a/DOCS/WIN-01-TERMINAL-FILE.md b/DOCS/WIN-01-TERMINAL-FILE.md new file mode 100644 index 0000000..ce8c880 --- /dev/null +++ b/DOCS/WIN-01-TERMINAL-FILE.md @@ -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 # 이름 μ§€μ • μ„Έμ…˜ μ‹œμž‘ +tmux attach -t # νŠΉμ • μ„Έμ…˜ λ‹€μ‹œ μ—°κ²° +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 # μ‹€ν–‰ λͺ…λ Ήμ–΄ +``` + +| 단좕킀 | λ™μž‘ | +| :--- | :--- | +| `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) diff --git a/DOCS/WIN-02-SYSTEM-DEVOPS.md b/DOCS/WIN-02-SYSTEM-DEVOPS.md new file mode 100644 index 0000000..4b451ba --- /dev/null +++ b/DOCS/WIN-02-SYSTEM-DEVOPS.md @@ -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) diff --git a/DOCS/WIN-03-DEV-UTILS.md b/DOCS/WIN-03-DEV-UTILS.md new file mode 100644 index 0000000..9b15bf2 --- /dev/null +++ b/DOCS/WIN-03-DEV-UTILS.md @@ -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 # κ°€μƒν™˜κ²½μ— νŒ¨ν‚€μ§€ μ„€μΉ˜ +uv run # κ°€μƒν™˜κ²½μ„ μžλ™ κ΅¬μ„±ν•˜μ—¬ 슀크립트 μ‹€ν–‰ +uv tool install # 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 # νŠΉμ • 파일 λ°”λ‘œ μ—΄κΈ° +codium --install-extension # ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ μ„€μΉ˜ +codium --list-extensions # μ„€μΉ˜λœ ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ λͺ©λ‘ 확인 +``` + +--- + +[⬅️ 이전: 2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps](./WIN-02-SYSTEM-DEVOPS.md) | [🏠 메인 README](../README.md) | [λ‹€μŒ: 4. AI 개발 μ—μ΄μ „νŠΈ ➑️](./WIN-04-AI-AGENTS.md) diff --git a/DOCS/WIN-04-AI-AGENTS.md b/DOCS/WIN-04-AI-AGENTS.md new file mode 100644 index 0000000..13188df --- /dev/null +++ b/DOCS/WIN-04-AI-AGENTS.md @@ -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) diff --git a/DOCS/WIN-05-VIBE-ASSISTANTS.md b/DOCS/WIN-05-VIBE-ASSISTANTS.md new file mode 100644 index 0000000..66aa0b8 --- /dev/null +++ b/DOCS/WIN-05-VIBE-ASSISTANTS.md @@ -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) diff --git a/README.md b/README.md index 837d337..6a2a49d 100644 --- a/README.md +++ b/README.md @@ -1,811 +1,104 @@ -# ν•„μˆ˜ 터미널 도ꡬ +# ν•„μˆ˜ 터미널 & λ°”μ΄λΈŒ μ½”λ”© 도ꡬ λͺ¨μŒ (`install-sh`) -ν„°λ―Έλ„μ—μ„œ μ‚¬μš©ν•˜λŠ” μœ μš©ν•œ CLI/TUI 도ꡬ λͺ¨μŒμž…λ‹ˆλ‹€. 단 ν•œ μ€„μ˜ λͺ…λ Ήμ–΄λ‘œ λ‹€μ–‘ν•œ 개발 생산성 도ꡬλ₯Ό μ„€μΉ˜ν•˜κ³  관리할 수 μžˆμŠ΅λ‹ˆλ‹€. +단 ν•œ μ€„μ˜ λͺ…λ Ήμ–΄λ‘œ λ‹€μ–‘ν•œ 개발 생산성 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
(메인 λ„€λΉ„κ²Œμ΄μ…˜ ν—ˆλΈŒ)"] + NEC["NECESSARY.md
(ν•„μˆ˜ 핡심 도ꡬ μš”μ•½λ³Έ)"] + 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. 터미널 관리 & 파일 μœ ν‹Έλ¦¬ν‹° -* **[tmux](https://github.com/tmux/tmux)** - κ°•λ ₯ν•œ 터미널 λ©€ν‹°ν”Œλ ‰μ„œ (μ„Έμ…˜ 관리 및 ν™”λ©΄ λΆ„ν• , WindowsλŠ” psmux둜 μ„€μΉ˜) +> πŸ”— **μ„€μΉ˜ κ°€μ΄λ“œ:** [🍎 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 킀바인딩 지원) +* **[superfile](https://github.com/yorukot/superfile)** - λͺ¨λ˜ν•˜κ³  μˆ˜λ €ν•œ 터미널 기반 λ“€μ–Ό νŒ¨λ„ 파일 κ΄€λ¦¬μž (Vim 킀바인딩 지원) * **[dua](https://github.com/byron/dua-cli)** - 병렬 μŠ€μΊ”μ„ μ§€μ›ν•˜λŠ” μ΄ˆκ³ μ† λ””μŠ€ν¬ μ‚¬μš©λŸ‰ 뢄석 도ꡬ +--- + ### 🐳 2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps -* **[bottom](https://github.com/ClementTsang/bottom)** - CPU, λ©”λͺ¨λ¦¬, λ„€νŠΈμ›Œν¬ 등을 μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§ν•˜λŠ” TUI +> πŸ”— **μ„€μΉ˜ κ°€μ΄λ“œ:** [🍎 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 κ°€μ΄λ“œ 제곡) -* **[lazydocker](https://github.com/jesseduffield/lazydocker)** - 도컀 μ»¨ν…Œμ΄λ„ˆ, 이미지, λ³Όλ₯¨μ„ μ‹œκ°μ μœΌλ‘œ μ œμ–΄ν•˜λŠ” TUI * **[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) -### πŸ› οΈ 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 개발 μ—μ΄μ „νŠΈ (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 μ½”λ”© μ–΄μ‹œμŠ€ν„΄νŠΈ 및 μΆ”μ²œ ν”ŒλŸ¬κ·ΈμΈ νŒ¨ν‚€μ§€ 일괄 μ„€μΉ˜ 도ꡬ +* **[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 기반의 μ˜€ν”ˆμ†ŒμŠ€ μ½”λ“œ 리뷰 μžλ™ν™” 도ꡬ --- -## πŸš€ μ„€μΉ˜ κ°€μ΄λ“œ - -### 🍎 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 - > ``` - -* **VSCodium (codium):** - ```bash - curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codium.sh?ref_type=heads" | bash - ``` - -#### πŸ€– 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 - ``` - -#### 🧠 5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ (Vibe Coding Assistants) - -* **graphify:** - ```bash - curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.sh?ref_type=heads" | bash - ``` - > πŸ’‘ **사전 μš”κ΅¬μ‚¬ν•­:** Python νŒ¨ν‚€μ§€ κ΄€λ¦¬μž `uv`κ°€ λ¨Όμ € μ„€μΉ˜λ˜μ–΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. - -* **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') - > ``` - -* **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 - $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 개발 μ—μ΄μ „νŠΈ (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 - ``` - -#### 🧠 5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ (Vibe Coding Assistants) - -* **graphify:** - * **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 - $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`κ°€ λ¨Όμ € μ„€μΉ˜λ˜μ–΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. - -* **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 # 이름 μ§€μ • μ„Έμ…˜ μ‹œμž‘ -tmux attach -t # νŠΉμ • μ„Έμ…˜ λ‹€μ‹œ μ—°κ²° -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 . # 둜컬 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 μš”μ²­ μ‹€ν–‰ | -| `?` | 전체 단좕킀 치트 μ‹œνŠΈ 일람 λ‘œλ“œ | - -#### 3.2. uv -Rust둜 μž‘μ„±λœ μ΄ˆκ³ μ† μ°¨μ„ΈλŒ€ Python νŒ¨ν‚€μ§€ 및 ν”„λ‘œμ νŠΈ 톡합 관리 λ„κ΅¬μž…λ‹ˆλ‹€. 기쑴의 `pip`, `pip-tools`, `virtualenv`, `pyenv`, `pipx`, `poetry`λ₯Ό 단 ν•˜λ‚˜μ˜ 단일 λ°”μ΄λ„ˆλ¦¬λ‘œ μ™„λ²½νžˆ λŒ€μ²΄ν•˜λ©° 10~100λ°° λΉ λ₯Έ 속도λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. - -```bash -uv venv # ν˜„μž¬ 폴더에 κ°€μƒν™˜κ²½(.venv) μ΄ˆκ³ μ† 생성 -uv pip install # κ°€μƒν™˜κ²½μ— νŒ¨ν‚€μ§€ μ„€μΉ˜ -uv run # κ°€μƒν™˜κ²½μ„ μžλ™ κ΅¬μ„±ν•˜μ—¬ 슀크립트 μ‹€ν–‰ -uv tool install # CLI 도ꡬλ₯Ό 격리된 ν™˜κ²½μ— κΈ€λ‘œλ²Œ μ„€μΉ˜ -``` - -#### 3.3. VSCodium (codium) -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/)λ₯Ό κΈ°λ³Έ μ‚¬μš©ν•˜μ—¬ ν•„μš”ν•œ ν™•μž₯ κΈ°λŠ₯만 κΉ”λ”ν•˜κ²Œ μ„€μΉ˜ κ°€λŠ₯ - -```bash -codium . # ν˜„μž¬ 디렉토리λ₯Ό VSCodium으둜 μ—΄κΈ° -codium # νŠΉμ • 파일 λ°”λ‘œ μ—΄κΈ° -codium --install-extension # ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ μ„€μΉ˜ -codium --list-extensions # μ„€μΉ˜λœ ν™•μž₯ ν”ŒλŸ¬κ·ΈμΈ λͺ©λ‘ 확인 -``` - ---- - -### πŸ€– 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 # ν˜„μž¬ μ„€μΉ˜ μ™„λ£Œλœ ν”ŒλŸ¬κ·ΈμΈ μ—μ½”μ‹œμŠ€ν…œ λͺ©λ‘ 좜λ ₯ -``` - ---- - -### 🧠 5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ (Vibe Coding Assistants) - -#### 5.1. graphify -μ½”λ“œλ² μ΄μŠ€, λ¬Έμ„œ, μ•„ν‚€ν…μ²˜λ₯Ό 지식 κ·Έλž˜ν”„(Knowledge Graph)둜 κ΅¬μ‘°ν™”ν•˜μ—¬ AI μ—μ΄μ „νŠΈκ°€ λ°©λŒ€ν•œ μ½”λ“œλ² μ΄μŠ€λ₯Ό λ‹¨λ²ˆμ— νŒŒμ•…ν•˜κ³  μ§ˆλ¬Έμ— μ •λ°€ν•˜κ²Œ λ‹΅λ³€ν•  수 μžˆλ„λ‘ λ•λŠ” 지식 κ·Έλž˜ν”„ 뢄석 μ—”μ§„μž…λ‹ˆλ‹€. Antigravity, Claude Code, Codex, OpenCode λ“± λ‹€μ–‘ν•œ λ°”μ΄λΈŒ μ½”λ”© μ—μ΄μ „νŠΈμ™€ λ§€λ„λŸ½κ²Œ μ—°λ™λ˜λ©° Gemini MCP μ„œλ²„λ₯Ό μ§€μ›ν•©λ‹ˆλ‹€. - -##### [μ£Όμš” νŠΉμ§•] -* **닀차원 지식 κ·Έλž˜ν”„ ꡬ좕** β€” AST ꡬ문 뢄석과 μ‹œλ§¨ν‹± μš”μ•½μ„ 톡해 ν•¨μˆ˜, 클래슀, λͺ¨λ“ˆ κ°„μ˜ 호좜 및 상속 관계λ₯Ό μ‹œκ°μ  κ·Έλž˜ν”„λ‘œ 인덱싱 -* **μžμ—°μ–΄ 질의(Query) & 경둜 탐색(Path)** β€” μ½”λ“œλ² μ΄μŠ€μ— λŒ€ν•œ μ§ˆλ¬Έμ„ λ˜μ§€λ©΄ κ΄€λ ¨ μ„œλΈŒκ·Έλž˜ν”„λ₯Ό μΆ”μΆœν•˜κ³ , 두 심볼 κ°„μ˜ μ΅œλ‹¨ 호좜 경둜 좔적 -* **원클릭 μ—μ΄μ „νŠΈ 연동** β€” `graphify antigravity/claude/codex/opencode install` λͺ…λ Ήμ–΄λ‘œ μ—μ΄μ „νŠΈ κ·œμΉ™ 및 MCP ν™˜κ²½ μžλ™ μ…‹μ—… -* **Gemini MCP 연동** β€” Antigravity 및 Gemini ν™˜κ²½μ—μ„œ `mcp_config.json`을 톡해 μ‹€μ‹œκ°„ MCP μ„œλΉ„μŠ€λ‘œ 연동 - -##### [graphify κΈ°λ³Έ μ‚¬μš©λ²•] -```bash -graphify . # ν˜„μž¬ λ””λ ‰ν† λ¦¬μ˜ μ½”λ“œλ² μ΄μŠ€ κ·Έλž˜ν”„ λΉŒλ“œ/κ°±μ‹  -graphify query "ν”„λ‘œμ νŠΈμ˜ 핡심 ꡬ쑰와 μ§„μž…μ μ„ μ„€λͺ…ν•΄μ€˜" # 지식 κ·Έλž˜ν”„ 기반 μžμ—°μ–΄ 질의 -graphify path "AuthManager" "DatabasePool" # 두 심볼 κ°„μ˜ μ—°κ΄€ 호좜 관계 경둜 좔적 -graphify explain "WorkerProcess" # νŠΉμ • 클래슀/ν•¨μˆ˜ λ…Έλ“œμ˜ 상세 정보 확인 -graphify update . # AST 기반 μ΄ˆκ³ μ† 증뢄 μ—…λ°μ΄νŠΈ (λ¬΄λΉ„μš©) -``` - -#### 5.2. Open Code Review (ocr) -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_ diff --git a/VIBE-WORK/261107/SPLIT-README-DOCS-IMP-PLAN.md b/VIBE-WORK/261107/SPLIT-README-DOCS-IMP-PLAN.md new file mode 100644 index 0000000..923b4f0 --- /dev/null +++ b/VIBE-WORK/261107/SPLIT-README-DOCS-IMP-PLAN.md @@ -0,0 +1,58 @@ +# README.md OSλ³„Β·μΉ΄ν…Œκ³ λ¦¬λ³„ λ¬Έμ„œ λΆ„ν•  개편 κ³„νš (SPLIT-README-DOCS-IMP-PLAN) + +## 1. κ°œμš” +κΈ°μ‘΄ 단일 `README.md` 파일(811라인)이 λΉ„λŒ€ν•΄μ Έ μ›ν•˜λŠ” μš΄μ˜μ²΄μ œμ™€ λ„κ΅¬μ˜ μ„€μΉ˜ λͺ…λ Ήμ–΄λ₯Ό λΉ λ₯΄κ²Œ μ°ΎκΈ° μ–΄λ €μš΄ 문제λ₯Ό ν•΄κ²°ν•˜κΈ° μœ„ν•΄, **OS별(macOS/Linux, Windows) Γ— 5λŒ€ μΉ΄ν…Œκ³ λ¦¬λ³„**둜 총 10개의 독립 κ°€μ΄λ“œ λ¬Έμ„œ(`DOCS/` 디렉토리 λ‚΄ 영문 λŒ€λ¬Έμž+`-` κ·œμΉ™ μ€€μˆ˜)둜 λΆ„λ¦¬ν•˜κ³ , 메인 `README.md`λŠ” 직관적인 λ„€λΉ„κ²Œμ΄μ…˜ ν—ˆλΈŒλ‘œ κ°œνŽΈν•©λ‹ˆλ‹€. + +```mermaid +flowchart TD + README["README.md (메인 인덱슀 ν—ˆλΈŒ)"] + NEC["NECESSARY.md (ν•„μˆ˜ 핡심 도ꡬ λͺ¨μŒ)"] + README --> NEC + + subgraph UNIX["🍎 macOS / 🐧 Linux (Bash)"] + U1["DOCS/UNIX-01-TERMINAL-FILE.md
1. 터미널 관리 & 파일 μœ ν‹Έλ¦¬ν‹°"] + U2["DOCS/UNIX-02-SYSTEM-DEVOPS.md
2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps"] + U3["DOCS/UNIX-03-DEV-UTILS.md
3. 개발 μœ ν‹Έλ¦¬ν‹°"] + U4["DOCS/UNIX-04-AI-AGENTS.md
4. AI 개발 μ—μ΄μ „νŠΈ"] + U5["DOCS/UNIX-05-VIBE-ASSISTANTS.md
5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ"] + end + + subgraph WIN["πŸ’» Windows (PowerShell / CMD)"] + W1["DOCS/WIN-01-TERMINAL-FILE.md
1. 터미널 관리 & 파일 μœ ν‹Έλ¦¬ν‹°"] + W2["DOCS/WIN-02-SYSTEM-DEVOPS.md
2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps"] + W3["DOCS/WIN-03-DEV-UTILS.md
3. 개발 μœ ν‹Έλ¦¬ν‹°"] + W4["DOCS/WIN-04-AI-AGENTS.md
4. AI 개발 μ—μ΄μ „νŠΈ"] + W5["DOCS/WIN-05-VIBE-ASSISTANTS.md
5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ"] + end + + README --> UNIX + README --> WIN +``` + +## 2. μž‘μ—… 단계 및 체크리슀트 + +### 단계 1: μ‹€ν–‰ κ³„νš 수립 +- [x] μž‘μ—… κ³„νšμ„œ(`VIBE-WORK/261107/SPLIT-README-DOCS-IMP-PLAN.md`) μž‘μ„± + +### 단계 2: macOS / Linux (`UNIX-*`) μΉ΄ν…Œκ³ λ¦¬λ³„ λ¬Έμ„œ 5μ’… 생성 +- [x] `DOCS/UNIX-01-TERMINAL-FILE.md` μž‘μ„± (tmux, rmux, Helix, superfile, dua μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/UNIX-02-SYSTEM-DEVOPS.md` μž‘μ„± (Docker, bottom, all-smi, ctop, lazydocker μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/UNIX-03-DEV-UTILS.md` μž‘μ„± (lazygit, uv, VSCodium μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/UNIX-04-AI-AGENTS.md` μž‘μ„± (Antigravity CLI, Claude Code, Codex CLI, OpenCode, pi μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/UNIX-05-VIBE-ASSISTANTS.md` μž‘μ„± (graphify, Open Code Review μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) + +### 단계 3: Windows (`WIN-*`) μΉ΄ν…Œκ³ λ¦¬λ³„ λ¬Έμ„œ 5μ’… 생성 +- [x] `DOCS/WIN-01-TERMINAL-FILE.md` μž‘μ„± (tmux/psmux, rmux, Helix, superfile, dua μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/WIN-02-SYSTEM-DEVOPS.md` μž‘μ„± (Docker, bottom, all-smi, ctop, lazydocker μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/WIN-03-DEV-UTILS.md` μž‘μ„± (lazygit, uv, VSCodium μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/WIN-04-AI-AGENTS.md` μž‘μ„± (Antigravity CLI, Claude Code, Codex CLI, OpenCode, pi μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) +- [x] `DOCS/WIN-05-VIBE-ASSISTANTS.md` μž‘μ„± (graphify, Open Code Review μ„€μΉ˜ 및 상세 μ‚¬μš©λ²•) + +### 단계 4: 메인 `README.md` ν—ˆλΈŒ 개편 +- [x] OS별 Γ— μΉ΄ν…Œκ³ λ¦¬λ³„ λ°”λ‘œκ°€κΈ° 맀트릭슀 ν…Œμ΄λΈ” 및 도ꡬ별 λ°”λ‘œκ°€κΈ° 링크 ꡬ성 +- [x] `NECESSARY.md` (ν•„μˆ˜ μœ ν‹Έ λͺ¨μŒ) μ•ˆλ‚΄ 및 Mermaid λ¬Έμ„œ ꡬ쑰도 포함 + +### 단계 5: μ™„λ£Œ λ³΄κ³ μ„œ μž‘μ„± 및 Graphify κ°±μ‹  / Git ν‘Έμ‹œ +- [x] μ™„λ£Œ λ³΄κ³ μ„œ(`VIBE-WORK/261107/SPLIT-README-DOCS-PHASE01.md`) μž‘μ„± +- [x] `uv tool run --from graphifyy graphify update .` μ‹€ν–‰ +- [x] Git commit 및 push diff --git a/VIBE-WORK/261107/SPLIT-README-DOCS-PHASE01.md b/VIBE-WORK/261107/SPLIT-README-DOCS-PHASE01.md new file mode 100644 index 0000000..f2277fc --- /dev/null +++ b/VIBE-WORK/261107/SPLIT-README-DOCS-PHASE01.md @@ -0,0 +1,44 @@ +# README.md OSλ³„Β·μΉ΄ν…Œκ³ λ¦¬λ³„ λ¬Έμ„œ λΆ„ν•  개편 μ™„λ£Œ λ³΄κ³ μ„œ (SPLIT-README-DOCS-PHASE01) + +## 1. κ°œμš” +κΈ°μ‘΄ 811쀄에 λ‹¬ν•˜λ˜ 단일 `README.md` λ¬Έμ„œλ₯Ό **운영체제(macOS/Linux, Windows) Γ— 5λŒ€ μΉ΄ν…Œκ³ λ¦¬λ³„**둜 총 10개의 독립 κ°€μ΄λ“œ λ¬Έμ„œ(`DOCS/UNIX-01~05`, `DOCS/WIN-01~05`)둜 λΆ„λ¦¬ν•˜κ³ , 메인 `README.md`λŠ” μ›ν•˜λŠ” μš΄μ˜μ²΄μ œμ™€ μΉ΄ν…Œκ³ λ¦¬λ‘œ μ¦‰μ‹œ 이동할 수 μžˆλŠ” κΉ”λ”ν•œ 인덱슀 ν—ˆλΈŒλ‘œ μ „λ©΄ κ°œνŽΈν•˜μ˜€μŠ΅λ‹ˆλ‹€. + +```mermaid +flowchart LR + README["README.md
(메인 인덱슀 ν—ˆλΈŒ)"] + NEC["NECESSARY.md
(ν•„μˆ˜ 도ꡬ μš”μ•½λ³Έ)"] + README --> NEC + + subgraph UNIX["🍎 macOS / 🐧 Linux (DOCS/UNIX-*.md)"] + 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 (DOCS/WIN-*.md)"] + 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 +``` + +## 2. λΆ„ν•  μƒμ„±λœ λ¬Έμ„œ λͺ©λ‘ + +| ꡬ뢄 | macOS / Linux (Bash) | Windows (PowerShell / CMD) | +| :--- | :--- | :--- | +| **1. 터미널 관리 & 파일 μœ ν‹Έλ¦¬ν‹°** | `DOCS/UNIX-01-TERMINAL-FILE.md` | `DOCS/WIN-01-TERMINAL-FILE.md` | +| **2. μ‹œμŠ€ν…œ & μ»¨ν…Œμ΄λ„ˆ DevOps** | `DOCS/UNIX-02-SYSTEM-DEVOPS.md` | `DOCS/WIN-02-SYSTEM-DEVOPS.md` | +| **3. 개발 μœ ν‹Έλ¦¬ν‹° & 에디터** | `DOCS/UNIX-03-DEV-UTILS.md` | `DOCS/WIN-03-DEV-UTILS.md` | +| **4. AI 개발 μ—μ΄μ „νŠΈ** | `DOCS/UNIX-04-AI-AGENTS.md` | `DOCS/WIN-04-AI-AGENTS.md` | +| **5. λ°”μ΄λΈŒ μ½”λ”© λ„μš°λ―Έ** | `DOCS/UNIX-05-VIBE-ASSISTANTS.md` | `DOCS/WIN-05-VIBE-ASSISTANTS.md` | + +## 3. κ°œμ„  효과 +- **즉각적인 탐색성**: 메인 `README.md` 상단 맀트릭슀 ν‘œμ—μ„œ 본인의 OS와 μ›ν•˜λŠ” μΉ΄ν…Œκ³ λ¦¬ 링크만 ν΄λ¦­ν•˜λ©΄ ν•΄λ‹Ή OS μ „μš© 원클릭 μ„€μΉ˜ λͺ…령어와 단좕킀 μ•ˆλ‚΄λ§Œ κΉ”λ”ν•˜κ²Œ 확인할 수 μžˆμŠ΅λ‹ˆλ‹€. +- **μƒν˜Έ λ„€λΉ„κ²Œμ΄μ…˜**: 각 ν•˜μœ„ λ¬Έμ„œ 상단/ν•˜λ‹¨μ— 메인 `README.md` 볡귀 링크, λ°˜λŒ€νŽΈ OS λ¬Έμ„œ μ „ν™˜ 링크, 이전/λ‹€μŒ μΉ΄ν…Œκ³ λ¦¬ 이동 링크λ₯Ό λͺ¨λ‘ λ°°μΉ˜ν•˜μ—¬ λ¬Έμ„œ κ°„ 이동이 νŽΈλ¦¬ν•©λ‹ˆλ‹€.