필수 핵심 도구만 모은 NECESSARY.md 문서 추가
This commit is contained in:
mcchae committed
1 parent
1de104e30c
commit
8f2177b3b5
3 files changed
+368
No files matched your search
+289
@@ -0,0 +1,289 @@
|
||||
# 필수 핵심 터미널 도구 (Essential Terminal Tools)
|
||||
|
||||
개발 및 엔지니어링 작업에 반드시 필요한 핵심 도구만을 선별한 모음입니다. 단 한 줄의 명령어로 macOS, Linux, Windows 환경에서 설치하고 설정할 수 있습니다.
|
||||
|
||||
---
|
||||
|
||||
## 📂 핵심 지원 도구 목록
|
||||
|
||||
### 📁 1. 터미널 관리
|
||||
* **[tmux](https://github.com/tmux/tmux)** - 강력한 터미널 멀티플렉서 (세션 보존 및 화면 분할, Windows는 psmux로 설치)
|
||||
|
||||
### 🐳 2. 시스템 & 컨테이너 DevOps
|
||||
* **[bottom (btm)](https://github.com/ClementTsang/bottom)** - CPU, 메모리, 프로세스, 네트워크 등을 실시간 모니터링하는 TUI
|
||||
* **[Docker](https://www.docker.com/)** - 컨테이너 가상화 플랫폼 (Linux 자동 설치 지원)
|
||||
* **[ctop](https://github.com/bcicen/ctop)** - 실시간 컨테이너 메트릭 및 자원 사용량 모니터링 TUI
|
||||
|
||||
### 🛠️ 3. 개발 유틸리티
|
||||
* **[lazygit](https://github.com/jesseduffield/lazygit)** - Git 버전 관리를 키보드로 능숙하게 제어하는 시각적 TUI
|
||||
* **[uv](https://docs.astral.sh/uv/)** - 초고속 Rust 기반 Python 패키지 & 프로젝트 통합 관리자
|
||||
|
||||
### 🤖 4. AI 개발 에이전트 & 도우미
|
||||
* **[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
|
||||
* **[graphify](https://github.com/astral-sh/uv)** - 코드베이스를 지식 그래프로 변환하여 에이전트의 컨텍스트 이해를 극대화하는 분석 도구
|
||||
|
||||
---
|
||||
|
||||
## 🚀 빠른 설치 가이드
|
||||
|
||||
### 🍎 MacOS / 🐧 Linux (Bash)
|
||||
|
||||
```bash
|
||||
# 1. 터미널 관리
|
||||
# tmux
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.sh?ref_type=heads" | bash
|
||||
|
||||
# 2. 시스템 & 컨테이너 DevOps
|
||||
# bottom (btm)
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash
|
||||
|
||||
# Docker (Linux 전용)
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash
|
||||
|
||||
# ctop
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.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
|
||||
|
||||
# 4. AI 개발 에이전트 & 도우미
|
||||
# Antigravity CLI (agy)
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash
|
||||
|
||||
# Claude Code
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
|
||||
|
||||
# Codex CLI
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
|
||||
|
||||
# graphify (uv 필요)
|
||||
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.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:**
|
||||
```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
|
||||
```
|
||||
|
||||
#### 2. 시스템 & 컨테이너 DevOps
|
||||
* **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
|
||||
```
|
||||
|
||||
* **Docker:**
|
||||
[Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)를 설치하거나, WSL2 내부에서 리눅스용 스크립트를 사용하세요.
|
||||
|
||||
* **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
|
||||
```
|
||||
|
||||
#### 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:**
|
||||
```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:**
|
||||
```powershell
|
||||
irm https://astral.sh/uv/install.ps1 | iex
|
||||
```
|
||||
|
||||
#### 4. AI 개발 에이전트 & 도우미
|
||||
* **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
|
||||
```
|
||||
|
||||
* **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
|
||||
```
|
||||
|
||||
* **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
|
||||
```
|
||||
|
||||
* **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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📖 필수 도구 핵심 사용법 및 팁
|
||||
|
||||
### 1. tmux
|
||||
터미널 세션을 백그라운드에 보존하고 화면을 분할하여 사용할 수 있는 멀티플렉서입니다.
|
||||
```bash
|
||||
tmux # 새 세션 가동
|
||||
tmux new -s <name> # 이름 지정 세션 시작
|
||||
tmux attach -t <name> # 특정 세션 다시 연결
|
||||
tmux ls # 가동 중인 세션 목록 보기
|
||||
```
|
||||
|
||||
| 단축키 | 동작 |
|
||||
| :--- | :--- |
|
||||
| `Ctrl-a` | Prefix key (기본값) |
|
||||
| `Prefix \|` | 화면 수평(좌우) 분할 |
|
||||
| `Prefix -` | 화면 수직(위아래) 분할 |
|
||||
| `Prefix h/j/k/l` | 패널 간 이동 (Vim 스타일) |
|
||||
| `Prefix d` | 현재 세션에서 이탈 (Detach) |
|
||||
|
||||
> 💡 Windows에서는 Rust 기반 네이티브 멀티플렉서인 `psmux`가 설치되어 동일한 키바인딩과 설정을 지원합니다.
|
||||
|
||||
---
|
||||
|
||||
### 2. bottom (btm)
|
||||
CPU, 메모리, 프로세스, 네트워크 및 디스크 사용량을 실시간으로 시각화하는 TUI 모니터입니다.
|
||||
```bash
|
||||
btm # 기본 모드로 실행
|
||||
btm --basic # 차트 그래프를 생략한 콤팩트 모드
|
||||
```
|
||||
|
||||
| 단축키 | 동작 |
|
||||
| :--- | :--- |
|
||||
| `h / j / k / l` | 위젯/항목 간 이동 |
|
||||
| `dd` | 선택한 프로세스 강제 종료 (Kill) |
|
||||
| `e` | 선택한 프로세스 트리 펼치기/접기 |
|
||||
| `q` | 종료 |
|
||||
|
||||
---
|
||||
|
||||
### 3. Docker & ctop
|
||||
- **Docker**: 애플리케이션을 컨테이너 환경으로 패키징하고 배포하는 플랫폼입니다.
|
||||
- **ctop**: 실행 중인 모든 컨테이너의 CPU, 메모리, 네트워크, I/O를 실시간 top 스타일로 보여주는 모니터입니다.
|
||||
|
||||
```bash
|
||||
ctop # 실시간 컨테이너 모니터링 시작
|
||||
```
|
||||
|
||||
| 단축키 | 동작 |
|
||||
| :--- | :--- |
|
||||
| `Enter` | 컨테이너 상세 메뉴 열기 (로그 보기, 정지, 재시작, 쉘 접속) |
|
||||
| `l` | 선택한 컨테이너 로그 실시간 스트리밍 확인 |
|
||||
| `s` | CPU / 메모리 등 메트릭 정렬 기준 변경 |
|
||||
| `q` | 종료 |
|
||||
|
||||
---
|
||||
|
||||
### 4. lazygit
|
||||
Git 명령어 없이도 키보드만으로 커밋, 브랜치 병합, 리베이스, 충돌 해결 등을 시각적으로 완벽하게 제어할 수 있는 TUI입니다.
|
||||
```bash
|
||||
lazygit # 현재 git 저장소에서 실행
|
||||
```
|
||||
|
||||
| 패널 번호 | 패널 구분 | 주요 기능 |
|
||||
| :--- | :--- | :--- |
|
||||
| `1` | Status | 저장소 상태 및 Git 정보 확인 |
|
||||
| `2` | Files | 스테이징(`Space`), 커밋(`c`), 변경사항 확인 |
|
||||
| `3` | Branches | 브랜치 전환(`Space`), 새 브랜치(`n`), 병합(`M`) |
|
||||
| `4` | Commits | 커밋 로그 확인, 체리픽(`c`), 리셋/스쿼시 |
|
||||
| `5` | Stash | 스태시 저장 및 복원 |
|
||||
|
||||
---
|
||||
|
||||
### 5. uv
|
||||
Rust로 작성된 차세대 초고속 Python 패키지/프로젝트 관리자입니다. `pip`, `poetry`, `pyenv`의 기능을 한 도구로 대체합니다.
|
||||
```bash
|
||||
uv venv # 초고속 가상환경(.venv) 생성
|
||||
uv pip install <package> # 초고속 패키지 설치
|
||||
uv run <script.py> # 가상환경 격리 실행
|
||||
uv tool install <cli-tool> # 독립된 CLI 도구 글로벌 설치
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. AI 개발 에이전트 (Antigravity, Claude, Codex)
|
||||
|
||||
#### 6.1. Antigravity CLI (agy)
|
||||
Google DeepMind의 Antigravity 플랫폼 터미널 코딩 에이전트입니다.
|
||||
```bash
|
||||
agy # 대화형 코딩 세션 시작
|
||||
agy -p "작업 내용" # 단발성 프롬프트 실행
|
||||
```
|
||||
|
||||
#### 6.2. Claude Code
|
||||
Anthropic의 공식 터미널 기반 대화형 코딩 어시스턴트입니다.
|
||||
```bash
|
||||
claude # 대화형 코딩 세션 시작
|
||||
claude -p "작업 내용" # 단발성 프롬프트 실행
|
||||
```
|
||||
|
||||
#### 6.3. Codex CLI
|
||||
OpenAI의 공식 터미널 기반 로컬 대화형 코딩 에이전트입니다.
|
||||
```bash
|
||||
codex auth # 인증 로그인
|
||||
codex # 대화형 코딩 세션 시작
|
||||
codex -p "작업 내용" # 단발성 빌드/수정 지시
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. graphify
|
||||
코드베이스와 문서를 지식 그래프(Knowledge Graph)로 인덱싱하여 복잡한 프로젝트 구조를 빠르게 분석하고 질문에 정밀하게 답하도록 돕는 도구입니다.
|
||||
```bash
|
||||
graphify . # 현재 프로젝트 그래프 빌드/갱신
|
||||
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘" # 지식 그래프 기반 자연어 질의
|
||||
graphify path "AuthManager" "DatabasePool" # 두 심볼 간의 연관 호출 관계 경로 추적
|
||||
graphify explain "WorkerProcess" # 특정 클래스/함수 노드의 상세 정보 확인
|
||||
graphify update . # AST 기반 초고속 증분 업데이트 (무비용)
|
||||
```
|
||||
Reference in new issue
Block a user