필수 터미널 도구

터미널에서 사용하는 유용한 CLI/TUI 도구 모음입니다. 단 한 줄의 명령어로 다양한 개발 생산성 도구를 설치하고 관리할 수 있습니다.

---

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

📁 1. 터미널 관리 & 파일 유틸리티

• tmux - 강력한 터미널 멀티플렉서 (세션 관리 및 화면 분할, Windows는 psmux로 설치)
• Helix - 현대적이고 강력한 터미널 기반 모달 텍스트 에디터 (LSP 및 구문 강조 기본 내장)
• superfile - 모던하고 수려한 터미널 기반 파일 관리자 (Vim 키바인딩 지원)
• dua - 병렬 스캔을 지원하는 초고속 디스크 사용량 분석 도구

🐳 2. 시스템 & 컨테이너 DevOps

• bottom - CPU, 메모리, 네트워크 등을 실시간 모니터링하는 TUI
• Docker - 컨테이너 플랫폼 (Linux 자동 설치 지원, Mac/Windows 가이드 제공)
• lazydocker - 도커 컨테이너, 이미지, 볼륨을 시각적으로 제어하는 TUI
• ctop - 실시간 컨테이너 메트릭 및 자원 모니터링 TUI

🛠️ 3. 개발 유틸리티 & 웹 터미널

• lazygit - Git 버전 관리를 키보드로 능숙하게 제어하는 시각적 TUI
• uv - 초고속 Rust 기반 Python 패키지 & 프로젝트 통합 관리자

🤖 4. AI 개발 에이전트 (AI Agents)

• Antigravity CLI (agy) - Antigravity 2.0 플랫폼의 경량화 터미널 코딩 에이전트 CLI
• pi - 대화형 CLI AI 코딩 어시스턴트 및 추천 플러그인 패키지 일괄 설치 도구

---

🚀 설치 가이드

🍎 MacOS / 🐧 Linux (Bash)

📁 1. 터미널 관리 & 파일 유틸리티

• tmux:

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

• Helix:

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

• superfile:

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

• dua:

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

🐳 2. 시스템 & 컨테이너 DevOps

• Docker (Linux 전용 — macOS/Windows 사용자는 하단 사용법 가이드 참고):

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

• bottom:

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

• ctop:

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

• lazydocker:

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

🛠️ 3. 개발 유틸리티 & 웹 터미널

• lazygit:

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

• uv:

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

  💡 설치 후 ${HOME}/.local/bin이 PATH에 없으면 추가하세요:

  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  

🤖 4. AI 개발 에이전트 (AI Agents)

• Antigravity CLI (agy):

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

• pi (Pi Coding Agent + 추천 패키지):

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

---

💻 Windows (PowerShell / CMD)

📁 1. 터미널 관리 & 파일 유틸리티

• tmux (Windows는 psmux 설치):

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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 OpenSSH Server 참고: 스크립트 가동 시 OpenSSH Server(sshd)가 미설치된 상태라면 자동으로 감지 및 백그라운드 설치 후 기동합니다. (관리자 권한이 필요할 수 있습니다.)
  💡 Windows tmux(psmux) 참고: Windows 환경에서는 Rust 기반으로 빌드되어 성능이 뛰어난 네이티브 Windows 터미널 멀티플렉서인 psmux가 설치됩니다.

• Helix:

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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 창에서 설치 시:

    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"
    

  • 파워쉘 창에서 설치 시:

    $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 창에서 설치 시:

    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"
    

  • 파워쉘 창에서 설치 시:

    $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를 수동 설치하거나, WSL2 내부에서 리눅스용 install-docker.sh를 실행하세요.

• bottom:

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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
    

• ctop:

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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 창에서 설치 시:

    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"
    

  • 파워쉘 창에서 설치 시:

    $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 창에서 설치 시:

    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"
    

  • 파워쉘 창에서 설치 시:

    $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 창에서 설치 시:

    powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
    

  • 파워쉘 창에서 설치 시:

    irm https://astral.sh/uv/install.ps1 | iex
    

  💡 설치 후 $env:USERPROFILE\.local\bin이 PATH에 없으면 추가하세요:

  [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User')
  

🤖 4. AI 개발 에이전트 (AI Agents)

• Antigravity CLI (agy):

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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
    

• pi (Pi Coding Agent + 추천 패키지):

  • 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"
    

  • 파워쉘 창에서 설치 시:

    $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
    

---

📖 도구별 상세 사용법 및 팁

---

📁 1. 터미널 관리 & 파일 유틸리티

1.1. tmux

터미널 멀티플렉서입니다. 하나의 터미널 창 내에서 백그라운드 세션을 유지하고 자유롭게 분할(패널)하여 사용할 수 있습니다.

• 세션 관리 — 세션을 백그라운드로 보존 및 필요 시 재접속
• 화면 분할 — 터미널 화면 수평/수직 분할 및 동시 작업
• Vim 스타일 조작 — h/j/k/l 방향키를 통해 직관적으로 패널 이동 가능

tmux                  # 새 세션 가동
tmux new -s <name>    # 이름 지정 세션 시작
tmux attach -t <name> # 특정 세션 다시 연결
tmux ls               # 가동 중인 세션 목록 보기

단축키	동작
Ctrl-a	Prefix key (기본 단축키 Ctrl-b에서 변경됨)
Prefix |	화면 수평(좌우) 분할
Prefix -	화면 수직(위아래) 분할
Prefix h/j/k/l	패널 간 이동 (Vim 스타일)
Prefix r	.tmux.conf 설정 파일 즉시 리로드
Prefix Space	활성화된 패널 레이아웃 변경
Prefix o	활성화된 패널 회전 전환
Prefix ,	현재 창의 이름 변경
Prefix &	현재 활성화된 창 완전히 닫기

💡 install-tmux 스크립트는 최적화된 커스텀 .tmux.conf 파일을 사용자 홈 디렉토리에 배포합니다. (기존 설정 파일이 있다면 .tmux.conf.bak.*로 자동 백업됩니다.)
💡 Windows (PowerShell) 참고: 윈도우 환경에서 실행할 경우, OpenSSH Server 서비스(sshd)가 작동하지 않거나 없을 시 Windows 선택적 기능(Optional Capability)을 통하여 무인 설치 및 구동까지 완전 자동 지원합니다.
💡 Windows psmux 연동 참고: Windows에서는 네이티브 가상 터미널 환경을 선사하는 psmux가 설치되며, 기존 .tmux.conf 파일과 높은 수준으로 호환되어 동일한 설정과 vim 키바인딩을 사용할 수 있습니다.

1.2. Helix

터미널 환경에서 현대적인 사용성을 제공하는 모달(Modal) 텍스트 에디터입니다. 별도의 플러그인 설정 없이도 LSP(Language Server Protocol), 나무 모양 구문 트리 파서(Tree-sitter) 및 수려한 디자인 테마가 내장되어 있어 초보자부터 전문가까지 즉시 사용 가능합니다.

• LSP 기본 내장 — 자동 완성, 정의 이동, 타입 힌트 등 IDE급 개발 지원
• Tree-sitter 구문 분석 — 실시간 구문 분석을 통한 완벽한 색상 하이라이팅 및 스마트 영역 탐색
• 모달 편집 모드 — Vim과 유사하면서도 더 현대적인 다중 커서 및 텍스트 객체 편집 지원

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.3. superfile

수려하고 미려한 디자인을 선사하는 고기능 터미널 파일 관리자입니다.

• 듀얼 패널 — 대칭형 레이아웃으로 직관적인 디렉토리 간 파일 조작
• Vim 키바인딩 — h/j/k/l 탐색 키 및 복사/붙여넣기 직관적 조작
• 시각적 미리보기 — 파일의 코드 하이라이팅 및 텍스트 미리보기 탑재

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.4. dua

SSD와 시스템 성능을 최대로 활용하여 유실된 용량을 추적하는 병렬 스캔 방식의 초고속 디스크 분석 유틸리티입니다.

• 초고속 스캔 — 대용량 디스크도 수 초 만에 고속으로 스캔 처리
• 대화형 TUI 모드 — 디렉토리 깊이를 탐색하며 불필요한 용량 점유 요소를 바로 제거

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 실시간 그래프화
• 정교한 프로세스 제어 — 프로세스를 정렬하고 직접 제어 및 강제 종료 가능

btm # 실행 명령어

단축키	동작
q / Esc	프로그램 종료
F1 ~ F5	메트릭 모니터링 탭 이동
↑ ↓	프로세스 목록 선택 이동
k	선택한 대상 프로세스 강제 종료 (Kill)
/	실시간 프로세스명 검색 필터링

2.2. Docker

컨테이너 기반 애플리케이션 가상화 플랫폼입니다.

• 자동 설치 지원: install-docker.sh는 Linux 환경에 필수적인 Docker Engine 및 Compose를 무인 설치합니다.

docker run hello-world     # 동작 유효성 테스트
docker ps                   # 가동 중인 컨테이너 목록
docker compose up -d        # 멀티 컨테이너 환경 백그라운드 구동
docker build -t <name> .    # 로컬 Dockerfile 빌드

💡 운영체제별 사용 가이드:

• macOS: Docker Desktop for Mac 또는 초경량 대안인 OrbStack 설치를 권장합니다.
• Windows: Docker Desktop for Windows를 단독 구동하시거나 WSL2 내부에서 리눅스 자동 설치 스크립트를 경유하여 활용하실 수 있습니다.
• Linux: 설치 완료 후 스크립트가 로그인된 유저를 자동으로 docker 권한 그룹에 할당합니다. 터미널 세션을 재로그인하시면 sudo 없이 편하게 제어하실 수 있습니다.

2.3. ctop / lazydocker

가동 중인 컨테이너들을 효율적으로 모니터링하고 관리할 수 있도록 지원하는 특화 TUI 듀오입니다.

도구명	특징 및 주요 권장 환경
ctop	실시간 리소스 메트릭(CPU, RAM, 네트워크 트래픽 등) 모니터링에 고도로 특화됨
lazydocker	컨테이너 상태 조회는 물론이고 시작, 정지, 재시작, 로그 보기, 내부 셸 진입 등 전반적인 컨테이너 수명 주기 관리에 적합함

[ctop 사용법]

ctop # 가동 명령어

단축키	동작
q / Esc	프로그램 종료
↑ ↓	컨테이너 리스트 이동
l	선택된 컨테이너의 실시간 로그 화면 로드
a	숨겨진 비활성 컨테이너까지 전부 표시
f	특정 컨테이너 이름 검색 필터링
S	선택된 컨테이너 정지
R	선택된 컨테이너 즉시 재시작

[lazydocker 사용법]

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(스쿼시 등)의 복잡성을 혁신적으로 단축

lazygit # 가동 명령어

단축키	동작
q	프로그램 종료
↓ ↑ → ←	파일 / 스테이지 / 커밋 / 브랜치 패널 포커스 이동
Space	현재 선택 파일 Stage / Unstage 전환
c	커밋 메시지 작성 윈도우 팝업
P / p	원격 저장소에 Push / Pull 요청 실행
?	전체 단축키 치트 시트 일람 로드

---

🤖 4. AI 개발 에이전트 (AI Agents)

4.1. Antigravity CLI

Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다.

• 로컬 터미널 밀착 코딩 — 별도의 무거운 데스크톱 GUI 없이 터미널 내부에서 완벽한 페어 프로그래밍 실현
• 보안 Google 계정 연동 — 첫 가동 시 Google Sign-In 보안 흐름이 브라우저와 클라이언트 단에서 연동 가동됨
• 유연한 자동화 — CI/CD 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원

agy                  # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항"     # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help           # 도움말 및 명령어 명세 로드

4.2. Pi Coding Agent

CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 install-pi 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.

[일괄 설치되는 추천 패키지 리스트]

패키지	설명
pi-subagents	오케스트레이션, 코드 리뷰, Auditor 등 세분화된 하위 태스크를 자식 에이전트들에 분할 위임
context-mode	컨텍스트 윈도우 보호 가드 및 session sandbox, BM25 로컬 검색 연동
pi-mcp-adapter	단 하나의 통합 MCP 프록시 툴을 가동하여 토큰 소모량을 아끼고 다양한 서버와 통합
pi-web-access	Exa, Perplexity, Gemini API를 통합하여 구글 검색, 실시간 웹 분석 및 YouTube 영상 이해 탑재
@plannotator/pi-extension	가동 중인 에이전트의 변경 계획안을 예쁜 로컬 브라우저 UI 상에서 직접 시각화하여 확인/승인
@juicesharp/rpiv-ask-user-question	애매모호한 요구 조건을 임의로 판단하지 않고 객관식/주관식 모달 문항을 띄워 사용자 동기화
pi-lens	실시간 LSP 진단, 코드 포맷터, 타입 분석기, 수정 전 분석 안정성 가드 가동
@juicesharp/rpiv-todo	에이전트가 처리 중인 Task 목록을 /reload 시점 이후에도 영속성 있게 관리
pi-simplify	최근 편집 및 변경된 코드를 리팩토링 및 리비전 제안 피드백 가동
@juicesharp/rpiv-advisor	행동 개시 직전 고차원 추론 모델의 2중 감사 피드백 확보
@juicesharp/rpiv-pi	리서치 -> 설계 -> 계획 -> 구현 -> 유효성 검증이라는 스킬 파이프라인 확립
@samfp/pi-memory	세션이 달라도 과거의 코딩 습관, 사용자 선호도 등을 계속 기억 및 반영
pi-btw	메인 에이전트 가동에 지장을 주지 않고 병렬로 대화를 주고받을 수 있는 사이드 톡 (/btw) 지원
pi-docparser	PDF, Office 파일, 다양한 시트 서식 로드 및 광학 문자 인식(OCR) 지원
pi-ollama-cloud	로컬 서버 사양이 무거워도 원격지 Ollama Cloud 서비스를 끌어와 동적 구동

💡 Ollama Cloud 사용 시 세팅 가이드:
~/.pi/agent/auth.json 파일을 열어 아래 서식과 같이 사용하시는 API Key를 명시해 주시면 에이전트 가동 시 원활하게 인식됩니다.

{
  "anthropic": {
    ...
  },
  "ollama-cloud": {
    "type": "api_key",
    "key": "YOUR_API_KEY"
  }
}

[pi 기본 사용법]

pi                  # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi --help           # 도움말 및 사용 가능 커맨드 파악
pi list             # 현재 설치 완료된 플러그인 에코시스템 목록 출력

---

GitLab: https://gitlab.com/publicproj/install-sh