From bc1f52c0305f83c6cc0855645a6bb61c4ce14648 Mon Sep 17 00:00:00 2001 From: Jerry Chae Date: Tue, 26 May 2026 11:34:12 +0900 Subject: [PATCH] =?UTF-8?q?README=20=EC=A0=95=EB=A6=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 728 ++++++++++++++++++++++++++---------------------------- 1 file changed, 345 insertions(+), 383 deletions(-) diff --git a/README.md b/README.md index 8902d69..67f19a4 100644 --- a/README.md +++ b/README.md @@ -1,451 +1,413 @@ # 필수 터미널 도구 -터미널에서 사용하는 유용한 CLI 도구 모음 +터미널에서 사용하는 유용한 CLI/TUI 도구 모음입니다. 단 한 줄의 명령어로 다양한 개발 생산성 도구를 설치하고 관리할 수 있습니다. -## 지원 도구 +--- -### 터미널 관리 -- [tmux](https://github.com/tmux/tmux) - 터미널 멀티플렉서 +## 📂 카테고리별 지원 도구 목록 -### 모니터링 -- [bottom](https://github.com/ClementTsang/bottom) - 호스트 모니터링 -- [superfile](https://github.com/yorukot/superfile) - 터미널 파일 관리자 -- [dua](https://github.com/byron/dua-cli) - 디스크 사용량 분석기 +### 📁 1. 터미널 관리 & 파일 유틸리티 +* **[tmux](https://github.com/tmux/tmux)** - 강력한 터미널 멀티플렉서 (세션 관리 및 화면 분할) +* **[superfile](https://github.com/yorukot/superfile)** - 모던하고 수려한 터미널 기반 파일 관리자 (Vim 키바인딩 지원) +* **[dua](https://github.com/byron/dua-cli)** - 병렬 스캔을 지원하는 초고속 디스크 사용량 분석 도구 -### 버전 관리 -- [lazygit](https://github.com/jesseduffield/lazygit) - Git 터미널 UI +### 🐳 2. 시스템 & 컨테이너 DevOps +* **[bottom](https://github.com/ClementTsang/bottom)** - CPU, 메모리, 네트워크 등을 실시간 모니터링하는 TUI +* **[Docker](https://www.docker.com/)** - 컨테이너 플랫폼 (Linux 자동 설치 지원, Mac/Windows 가이드 제공) +* **[lazydocker](https://github.com/jesseduffield/lazydocker)** - 도커 컨테이너, 이미지, 볼륨을 시각적으로 제어하는 TUI +* **[ctop](https://github.com/bcicen/ctop)** - 실시간 컨테이너 메트릭 및 자원 모니터링 TUI -### Docker 관련 -- [Docker](https://www.docker.com/) - 컨테이너 플랫폼 (Linux 자동 설치, Mac/Windows는 안내) -- [lazydocker](https://github.com/jesseduffield/lazydocker) / [ctop](https://github.com/bcicen/ctop) - 컨테이너 TUI (둘 중 하나 선택) +### 🛠️ 3. 개발 유틸리티 & 웹 터미널 +* **[lazygit](https://github.com/jesseduffield/lazygit)** - Git 버전 관리를 키보드로 능숙하게 제어하는 시각적 TUI +* **[uv](https://docs.astral.sh/uv/)** - 초고속 Rust 기반 Python 패키지 & 프로젝트 통합 관리자 -### 파이썬 관련 -- [uv](https://docs.astral.sh/uv/) - Python 패키지 관리자 +### 🤖 4. AI 개발 에이전트 (AI Agents) +* **[Antigravity CLI (agy)](https://antigravity.google)** - Antigravity 2.0 플랫폼의 경량화 터미널 코딩 에이전트 CLI +* **[pi](https://pi.dev/)** - 대화형 CLI AI 코딩 어시스턴트 및 추천 플러그인 패키지 일괄 설치 도구 -### AI Agent 관련 -- [Antigravity CLI](https://antigravity.google) - 경량화 터미널 코딩 에이전트 CLI -- [pi](https://pi.dev/) - CLI AI 코딩 어시스턴트 + 추천 패키지 일괄 설치 +--- -## 설치 +## 🚀 설치 가이드 -### MacOS / Linux +### 🍎 MacOS / 🐧 Linux (Bash) -**tmux:** +#### 📁 1. 터미널 관리 & 파일 유틸리티 + +* **tmux:** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.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 + ``` + +* **ctop:** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.sh?ref_type=heads" | bash + ``` + +* **lazydocker:** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.sh?ref_type=heads" | bash + ``` + +#### 🛠️ 3. 개발 유틸리티 & 웹 터미널 + +* **lazygit:** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.sh?ref_type=heads" | bash + ``` + +* **uv:** + ```bash + curl -LsSf https://astral.sh/uv/install.sh | sh + ``` + > 💡 설치 후 `${HOME}/.local/bin`이 PATH에 없으면 추가하세요: + > ```bash + > echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc + > source ~/.bashrc + > ``` + +#### 🤖 4. AI 개발 에이전트 (AI Agents) + +* **Antigravity CLI (agy):** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash + ``` + +* **pi (Pi Coding Agent + 추천 패키지):** + ```bash + curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash + ``` + +--- + +### 💻 Windows (PowerShell) + +#### 📁 1. 터미널 관리 & 파일 유틸리티 + +* **tmux:** + ```powershell + 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" + ``` + +* **superfile:** + ```powershell + 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" + ``` + +* **dua:** + ```powershell + 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" + ``` + +#### 🐳 2. 시스템 & 컨테이너 DevOps + +* **Docker:** + [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 수동 설치하거나, WSL2 내부에서 리눅스용 `install-docker.sh`를 실행하세요. + +* **bottom:** + ```powershell + 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" + ``` + +* **ctop:** + ```powershell + 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" + ``` + +* **lazydocker:** + ```powershell + 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" + ``` + +#### 🛠️ 3. 개발 유틸리티 & 웹 터미널 + +* **lazygit:** + ```powershell + 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" + ``` + +* **uv:** + ```powershell + powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" + ``` + > 💡 설치 후 `$env:USERPROFILE\.local\bin`이 PATH에 없으면 추가하세요: + > ```powershell + > [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User') + > ``` + +#### 🤖 4. AI 개발 에이전트 (AI Agents) + +* **Antigravity CLI (agy):** + ```powershell + 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" + ``` + +* **pi (Pi Coding Agent + 추천 패키지):** + ```powershell + 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" + ``` + +--- + +## 📖 도구별 상세 사용법 및 팁 + +--- + +### 📁 1. 터미널 관리 & 파일 유틸리티 + +#### 1.1. tmux +터미널 멀티플렉서입니다. 하나의 터미널 창 내에서 백그라운드 세션을 유지하고 자유롭게 분할(패널)하여 사용할 수 있습니다. + +* **세션 관리** — 세션을 백그라운드로 보존 및 필요 시 재접속 +* **화면 분할** — 터미널 화면 수평/수직 분할 및 동시 작업 +* **Vim 스타일 조작** — h/j/k/l 방향키를 통해 직관적으로 패널 이동 가능 ```bash -curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.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 -``` - -**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 -``` - -**lazygit:** - -```bash -curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazygit.sh?ref_type=heads" | bash -``` - -**Docker (Linux만 실행 — Mac/Windows 사용자는 아래 안내를 참고하세요):** - -```bash -curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash -``` - -**ctop / lazydocker** (컨테이너 모니터링 — 둘 중 하나 선택): - -> **ctop**은 실시간 컨테이너 메트릭 모니터링에 특화되어 있고, -> **lazydocker**은 직관적인 TUI로 컨테이너 관리(시작/중지/로그/재시작)에 특화되어 있습니다. -> Docker를 처음 사용한다면 lazydocker을 추천합니다. - -**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 -``` - -**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 -> ``` - -**Antigravity CLI (agy):** - -```bash -curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.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 -``` - -### Windows (PowerShell): - -**tmux:** - -```powershell -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" -``` - -**bottom:** - -```powershell -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" -``` - -**superfile:** - -```powershell -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" -``` - -**dua:** - -```powershell -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" -``` - -**lazygit:** - -```powershell -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" -``` - -**Docker:** [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 설치하세요. 또는 WSL2에서 리눅스용 `install-docker.sh`를 실행하세요. - -**ctop / lazydocker** (컨테이너 모니터링 — 둘 중 하나 선택): - -> **ctop**은 실시간 컨테이너 메트릭 모니터링에 특화되어 있고, -> **lazydocker**은 직관적인 TUI로 컨테이너 관리(시작/중지/로그/재시작)에 특화되어 있습니다. -> Docker를 처음 사용한다면 lazydocker을 추천합니다. - -**ctop:** - -```powershell -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" -``` - -**lazydocker:** - -```powershell -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" -``` - -**uv:** - -```powershell -powershell -ExecutionPolicy ByPass -c "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') -> ``` - -**Antigravity CLI (agy):** - -```powershell -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" -``` - -**pi (Pi Coding Agent + 추천 패키지):** - -```powershell -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" -``` - -## 도구별 사용법 - -### tmux - -터미널 멀티플렉서입니다. 하나의 터미널에서 여러 세션과 창을 관리할 수 있습니다. - -- **세션 관리** — 백그라운드 세션 유지, detach/attach -- **창 분할** — 수평/수직 분할로 여러 패널 동시 작업 -- **vim 스타일 이동** — h/j/k/l로 패널 간 이동 -- **마우스 지원** — 마우스로 패널 선택 및 스크롤 - -```bash -tmux # 새 세션 시작 +tmux # 새 세션 가동 tmux new -s # 이름 지정 세션 시작 -tmux attach -t # 세션 접속 -tmux ls # 세션 목록 +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 &` | 창 닫기 | +| 단축키 | 동작 | +| :--- | :--- | +| `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`를 홈 디렉토리에 자동 배포합니다. 기존 파일이 있으면 백업 후 덮어씁니다. +> 💡 `install-tmux` 스크립트는 최적화된 커스텀 `.tmux.conf` 파일을 사용자 홈 디렉토리에 배포합니다. (기존 설정 파일이 있다면 `.tmux.conf.bak.*`로 자동 백업됩니다.) -### bottom +#### 1.2. superfile +수려하고 미려한 디자인을 선사하는 고기능 터미널 파일 관리자입니다. -호스트 모니터링 터미널 UI 도구입니다. - -- **CPU, 메모리, 디스크, 네트워크** 실시간 모니터링 -- **프로세스 관리** (CPU/메모리 사용률별 정렬, 검색, 종료) -- **온도 센서 모니터링** -- **GPU 모니터링** (NVIDIA/AMD 지원) +* **듀얼 패널** — 대칭형 레이아웃으로 직관적인 디렉토리 간 파일 조작 +* **Vim 키바인딩** — h/j/k/l 탐색 키 및 복사/붙여넣기 직관적 조작 +* **시각적 미리보기** — 파일의 코드 하이라이팅 및 텍스트 미리보기 탑재 ```bash -btm +spf # 실행 명령어 (superfile이 아닌 spf를 사용합니다) ``` -| 단축키 | 동작 | -| ----------- | -------------------- | -| `q` / `Esc` | 종료 | -| `F1` ~ `F5` | 탭 전환 | -| `↑` `↓` | 프로세스 선택 | -| `k` | 선택한 프로세스 종료 | -| `/` | 검색 | +| 단축키 | 동작 | +| :--- | :--- | +| `q` | 프로그램 종료 | +| `h` `j` `k` `l` | 좌 / 하 / 상 / 우 디렉토리 이동 | +| `Enter` | 디렉토리 진입 및 대상 파일 열기 | +| `y` | Yank (클립보드에 파일 복사) | +| `d` | Delete (대상 파일 삭제) | +| `r` | Rename (이름 변경) | +| `/` | 실시간 빠른 검색 | +| `Tab` | 듀얼 패널 포커스 스왑 | -### superfile +> 💡 **중요:** 터미널 아이콘이 박스나 물음표 기호처럼 깨져 보일 경우, 사용하시는 터미널 폰트를 **Nerd Font** 계열로 설정해 주세요. +> 💡 **macOS iTerm2 한글 깨짐 팁:** 설정(`Settings` > `Profile` > `Text` > `Normalization`)에서 **NFC** 옵션으로 설정을 전환하시면 정상 표기됩니다. -터미널 기반 파일 관리자입니다. vim 스타일 키바인딩으로 직관적인 파일 탐색과 관리가 가능합니다. +#### 1.3. dua +SSD와 시스템 성능을 최대로 활용하여 유실된 용량을 추적하는 병렬 스캔 방식의 초고속 디스크 분석 유틸리티입니다. -- **듀얼 패널** — 좌우 패널로 파일/디렉토리 탐색 -- **vim 스타일 키바인딩** — h/j/k/l 이동, y/d/yank/delete -- **파일 미리보기** — 텍스트, 이미지, 코드 하이라이트 -- **대량 작업** — 선택 후 yank/delete/rename 일괄 처리 -- **플러그인 지원** — 확장 가능한 아키텍처 +* **초고속 스캔** — 대용량 디스크도 수 초 만에 고속으로 스캔 처리 +* **대화형 TUI 모드** — 디렉토리 깊이를 탐색하며 불필요한 용량 점유 요소를 바로 제거 ```bash -spf +dua # 현재 위치 사용량 검사 +dua /path/to/dir # 특정 디렉토리 지정 검사 +dua i # 대화형(Interactive) 인터랙티브 모드 구동 ``` -| 단축키 | 동작 | -| --------------- | ------------------------- | -| `q` | 종료 | -| `h` `j` `k` `l` | 좌/하/상/우 이동 | -| `Enter` | 디렉토리 진입 / 파일 열기 | -| `y` | Yank (복사) | -| `d` | Delete (삭제) | -| `r` | Rename | -| `/` | 검색 | -| `Tab` | 패널 전환 | +| 단축키 | 동작 | +| :--- | :--- | +| `↑` `↓` 또는 `j` `k` | 디렉토리 트리 위/아래 이동 | +| `?` | 단축키 도움말 팝업 | +| `d` | 선택한 디렉토리/파일 즉시 영구 삭제 | +| `q` / `Esc` | 프로그램 종료 | -> **참고**: 실행 명령어는 `spf`입니다 (`superfile`이 아님). -> **아이콘** 이 박스 물음표처럼 깨지는 경우가 발생한다면, terminal의 폰트를 Nerd Font 계열로 변경하세요. -> **MacOS** **iTerm2** 와 같은 곳에서는 한글이 나타나면 박스가 깨지는 현상이 발생합니다. 이 경우 `Settings/Profile/Text/Normalization` 에서 **NFC**로 변경하세요. +--- -### dua +### 🐳 2. 시스템 & 컨테이너 DevOps -디스크 사용량 분석 도구입니다. 병렬 처리로 빠르게 디스크 사용량을 분석합니다. +#### 2.1. bottom +기존의 `top`이나 `htop`을 완벽하게 대체하는 화려하고 가벼운 호스트 시스템 리소스 모니터링 TUI 도구입니다. -- **빠른 병렬 스캔** — SSD를 최대로 활용하여 디스크 사용량 즉시 표시 -- **인터랙티브 모드** — 탐색하며 불필요한 파일/디렉토리 삭제 -- **다양한 출력 형식** — 바이트, MB, GB, MiB, GiB 등 +* **풀 그래픽 차트** — CPU 코어별 사용률, RAM/Swap, 네트워크 흐름, 디스크 I/O 실시간 그래프화 +* **정교한 프로세스 제어** — 프로세스를 정렬하고 직접 제어 및 강제 종료 가능 ```bash -dua # 현재 디렉토리 사용량 -dua /path/to/dir # 특정 디렉토리 사용량 -dua i # 인터랙티브 모드 +btm # 실행 명령어 ``` -| 단축키 | 동작 | -| ----------------- | -------------- | -| `↑` `↓` / `j` `k` | 탐색 | -| `?` | 도움말 | -| `d` | 선택 항목 삭제 | -| `q` / `Esc` | 종료 | +| 단축키 | 동작 | +| :--- | :--- | +| `q` / `Esc` | 프로그램 종료 | +| `F1` ~ `F5` | 메트릭 모니터링 탭 이동 | +| `↑` `↓` | 프로세스 목록 선택 이동 | +| `k` | 선택한 대상 프로세스 강제 종료 (Kill) | +| `/` | 실시간 프로세스명 검색 필터링 | -### lazygit +#### 2.2. Docker +컨테이너 기반 애플리케이션 가상화 플랫폼입니다. -Git을 위한 터미널 UI 도구입니다. - -- **편리한 단축키**로 모든 git 작업 수행 -- **커밋, 브랜치, stash, rebase** 시각적 관리 -- **diff 뷰**로 변경사항 확인 -- **merge conflict** 해결 도구 +* **자동 설치 지원:** `install-docker.sh`는 Linux 환경에 필수적인 Docker Engine 및 Compose를 무인 설치합니다. ```bash -lazygit +docker run hello-world # 동작 유효성 테스트 +docker ps # 가동 중인 컨테이너 목록 +docker compose up -d # 멀티 컨테이너 환경 백그라운드 구동 +docker build -t . # 로컬 Dockerfile 빌드 ``` -| 단축키 | 동작 | -| --------------- | ------------------ | -| `q` | 종료 | -| `↓` `↑` `→` `←` | 화면 간 이동 | -| `Space` | 파일 Stage/Unstage | -| `c` | 커밋 작성 | -| `P` `p` | Push / Pull | -| `?` | 도움말 | +> 💡 **운영체제별 사용 가이드:** +> * **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` 없이 편하게 제어하실 수 있습니다. -### Docker +#### 2.3. ctop / lazydocker +가동 중인 컨테이너들을 효율적으로 모니터링하고 관리할 수 있도록 지원하는 특화 TUI 듀오입니다. -컨테이너 플랫폼입니다. `install-docker.sh`는 Linux에 Docker Engine을 자동 설치합니다. +| 도구명 | 특징 및 주요 권장 환경 | +| :--- | :--- | +| **ctop** | 실시간 리소스 메트릭(CPU, RAM, 네트워크 트래픽 등) 모니터링에 고도로 특화됨 | +| **lazydocker** | 컨테이너 상태 조회는 물론이고 시작, 정지, 재시작, 로그 보기, 내부 셸 진입 등 전반적인 컨테이너 수명 주기 관리에 적합함 | -- **컨테이너 실행/관리** — 애플리케이션을 격리된 환경에서 실행 -- **Docker Compose** — 멀티 컨테이너 애플리케이션 오케스트레이션 -- **BuildKit** — 빠른 이미지 빌드 +##### [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 -docker run hello-world # 설치 확인 -docker ps # 실행 중인 컨테이너 목록 -docker compose up -d # Compose 서비스 시작 -docker build -t . # 이미지 빌드 +lazygit # 가동 명령어 ``` -> **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에서 리눅스용 스크립트를 실행하세요. -> -> `install-docker.sh`는 Linux 전용입니다. 설치 후 현재 사용자를 `docker` 그룹에 추가하며, 재로그인 후 `docker` 명령어를 sudo 없이 사용할 수 있습니다. +| 단축키 | 동작 | +| :--- | :--- | +| `q` | 프로그램 종료 | +| `↓` `↑` `→` `←` | 파일 / 스테이지 / 커밋 / 브랜치 패널 포커스 이동 | +| `Space` | 현재 선택 파일 Stage / Unstage 전환 | +| `c` | 커밋 메시지 작성 윈도우 팝업 | +| `P` / `p` | 원격 저장소에 Push / Pull 요청 실행 | +| `?` | 전체 단축키 치트 시트 일람 로드 | -### ctop / lazydocker +--- -> **ctop**과 **lazydocker**은 모두 컨테이너 모니터링 TUI 도구입니다. 둘 중 하나를 선택하세요. -> -> | | ctop | lazydocker | -> | ---- | ------------------ | -------------------------------------- | -> | 특징 | 실시간 메트릭 중심 | 직관적 관리 TUI | -> | 추천 | 모니터링 위주 | 컨테이너 관리 위주, Docker 초보자 추천 | +### 🤖 4. AI 개발 에이전트 (AI Agents) -**ctop** — Docker/Podman 컨테이너 모니터링 터미널 UI +#### 4.1. Antigravity CLI +Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다. -- **실시간 컨테이너 메트릭** (CPU, 메모리, 네트워크, I/O) -- **컨테이너별 상태** 표시 및 필터링 -- **컨테이너 로그** 바로 보기 -- **정지/시작/재시작** 등 컨테이너 관리 +* **로컬 터미널 밀착 코딩** — 별도의 무거운 데스크톱 GUI 없이 터미널 내부에서 완벽한 페어 프로그래밍 실현 +* **보안 Google 계정 연동** — 첫 가동 시 Google Sign-In 보안 흐름이 브라우저와 클라이언트 단에서 연동 가동됨 +* **유연한 자동화** — CI/CD 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원 ```bash -ctop +agy # 대화형 코딩 에이전트 쉘 가동 +agy -p "요청사항" # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드) +agy --help # 도움말 및 명령어 명세 로드 ``` -| 단축키 | 동작 | -| ----------- | ------------------ | -| `q` / `Esc` | 종료 | -| `↑` `↓` | 컨테이너 선택 | -| `l` | 컨테이너 로그 보기 | -| `a` | 모든 컨테이너 표시 | -| `f` | 필터 | -| `S` | 정지 | -| `R` | 재시작 | +#### 4.2. Pi Coding Agent +CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 `install-pi` 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다. -> **macOS Apple Silicon 참고**: ctop은 native arm64 빌드를 제공하지 않습니다. Rosetta 2를 통해 amd64 바이너리로 실행됩니다. +##### [일괄 설치되는 추천 패키지 리스트] -**lazydocker** — 직관적인 Docker/Podman 관리 터미널 UI +| 패키지 | 설명 | +| :--- | :--- | +| [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 서비스를 끌어와 동적 구동 | -- **컨테이너/이미지/볼륨** 목록 및 상태 -- **컨테이너 로그** 실시간 보기 -- **컨테이너 시작/정지/재시작/삭제** -- **컨테이너 셸 진입** (exec) -- **Docker Compose** 서비스 관리 -- **커스텀 명령어** 키 바인딩 +> 💡 **Ollama Cloud 사용 시 세팅 가이드:** +> `~/.pi/agent/auth.json` 파일을 열어 아래 서식과 같이 사용하시는 API Key를 명시해 주시면 에이전트 가동 시 원활하게 인식됩니다. +> ```json +> { +> "anthropic": { +> ... +> }, +> "ollama-cloud": { +> "type": "api_key", +> "key": "YOUR_API_KEY" +> } +> } +> ``` +##### [pi 기본 사용법] ```bash -lazydocker -``` - -| 단축키 | 동작 | -| ------- | ----------------------- | -| `q` | 종료 | -| `↑` `↓` | 리스트 이동 | -| `Enter` | 컨테이너 로그 보기 | -| `s` | 컨테이너 정지 | -| `r` | 컨테이너 재시작 | -| `e` | 컨테이너 셸 진입 (exec) | -| `x` | 컨테이너 제거 | -| `[` `]` | 패널 간 이동 | - -### Antigravity CLI - -Google Antigravity 2.0 플랫폼의 경량화 터미널 인터페이스입니다. 쉘 환경에 완벽히 연동되는 차세대 코딩 에이전트입니다. - -- **원활한 CLI 작업** — 로컬 프로젝트 디렉토리에서 터미널 기반 에이전트 작동 -- **Google 로그인 연동** — 첫 실행 시 보안인증(Google Sign-In) 자동 트리거 -- **스크립트 친화성** — CI/CD 파이프라인이나 스크립트에서 자동화 가능 - -```bash -agy # 대화형 에이전트 쉘 시작 -agy -p "요청사항" # 단일 프롬프트 실행 -agy --help # 도움말 및 사용법 표시 -``` - -### Pi Coding Agent - -CLI 기반 AI 코딩 어시스턴트입니다. `install-pi` 스크립트는 Pi 본체와 함께 다음 추천 패키지를 일괄 설치합니다. - -| 패키지 | 설명 | -| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | -| [pi-subagents](https://pi.dev/packages/pi-subagents) | 하위 에이전트에 작업 위임 — 코드 리뷰, 스카우팅, 구현, 병렬 감사, 오케스트레이션, 백그라운드 작업 | -| [context-mode](https://pi.dev/packages/context-mode) | 컨텍스트 윈도우 보호 — 샌드박스 도구, 세션 연속성, BM25 지식 베이스, think-in-code 패러다임 | -| [pi-mcp-adapter](https://pi.dev/packages/pi-mcp-adapter) | MCP 서버를 Pi에서 사용 — 수백 개 툴 정의 대신 하나의 프록시 툴로 | -| [pi-web-access](https://pi.dev/packages/pi-web-access) | 웹 검색, 콘텐츠 추출, 영상 이해 — 설정 없는 Exa 검색, Perplexity, Gemini, 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) | 세션 간 유지되는 투두 리스트 — /reload 및 compaction 후에도 작업 보존, 의존성追踪 | -| [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, 오피스 문서, 스프레드시트, 이미지, OCR | -| [pi-ollama-cloud](https://pi.dev/packages/pi-ollama-cloud?name=ollama) | Ollama Cloud 제공자 플러그인 — 동적 모델 발견, 웹 검색/패치 도구, 로컬 서버 불필요 | - -> **Ollama Cloud 사용 시**: `~/.pi/agent/auth.json`에 API 키를 설정하세요. 자세한 내용은 [pi-ollama-cloud 문서](https://pi.dev/packages/pi-ollama-cloud?name=ollama)를 참조하세요. - -> ~/.pi/agent/auth.json에 "api.key" : "YOUR_API_KEY" 형태로 추가한다. - -```json -{ - "anthropic": { - ... - }, - "ollama-cloud": { - "type": "api_key", - "key": "..." - } -} -``` - -**pi** 사용법 - -```bash -pi # 대화형 세션 시작 -pi -p "질문" # 단일 질문 (print 모드) -pi --help # 도움말 -pi list # 설치된 패키지 목록 +pi # 대화형 페어 코딩 세션 개시 +pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드) +pi --help # 도움말 및 사용 가능 커맨드 파악 +pi list # 현재 설치 완료된 플러그인 에코시스템 목록 출력 ``` ---