안녕하세요! 오늘은 터미널 기반 AI 코딩 에이전트 oh-my-pi에 대해 알아보겠습니다. oh-my-pi는 IDE 기능이 내장된 혁신적인 코딩 도구로, LSP 통합, DAP 디버거, 웹 검색 등 18가지 핵심 기능을 제공합니다. 특히 TypeScript와 Rust로 구현되어 40개 이상의 모델 프로바이더를 지원하며, Claude Code와 같은 상용 도구의 무료 대안으로 활용할 수 있습니다.
이 블로그에서는 oh-my-pi의 핵심 기능, 기술 스택, 설치 방법, 실전 활용법, Claude Code와의 비교 등을 상세히 알아보겠습니다. 바로 시작해볼까요?
"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."
🤖 oh-my-pi란 무엇인가?
oh-my-pi는 Mario Zechner의 Pi 프로젝트를 fork하여 개발된 터미널 기반 AI 코딩 에이전트입니다. "A coding agent with the IDE wired in"이라는 설명처럼, IDE의 핵심 기능을 터미널 환경에 직접 통합한 혁신적인 도구입니다.
핵심 특징
- IDE 내장: LSP(Language Server Protocol)와 DAP(Debug Adapter Protocol)를 직접 통합
- 32개 내장 툴: Python/Bun 실행, 파일 시스템, 웹 검색 등 다양한 툴 제공
- 40+ 모델 프로바이더: Claude, GPT, Gemini, DeepSeek 등 다양한 AI 모델 지원
- 실시간 스트림: 모델 응답을 실시간으로 교정하고 제어
- GitHub 통합:
pr://,issue://,conflict://스킴 지원
oh-my-pi는 2026년 현재 10,000개 이상의 GitHub Stars와 6,907개의 커밋을 기록하며 활발하게 개발되고 있습니다. 831개의 fork는 개발자 커뮤니티의 높은 관심을 반영합니다.
🚀 핵심 기능 18가지 완벽 분석
oh-my-pi는 총 18가지 핵심 기능을 제공합니다. 각 기능의 특징과 활용 방법을 상세히 분석해보겠습니다.
1. 코드 실행 및 툴 콜백
Python과 Bun 코드를 직접 실행하며, 툴 콜백을 통해 실행 결과를 AI 모델에 실시간으로 전달합니다. 이를 통해 코드 테스트와 디버깅이 자동화됩니다.
# Python 코드 실행 예시
def calculate_sum(numbers):
return sum(numbers)
# oh-my-pi가 자동으로 실행하고 결과를 AI에 전달
result = calculate_sum([1, 2, 3, 4, 5])
print(f"Sum: {result}")2. LSP 통합 (13개 작업)
Language Server Protocol을 통해 IDE 수준의 코드 분석을 제공합니다. 13개의 LSP 작업을 지원합니다.
| LSP 작업 | 기능 설명 |
|---|---|
rename |
변수/함수 이름 일괄 변경 |
references |
참조 위치 검색 |
definition |
정의 위치 이동 |
completion |
자동 완성 |
hover |
타입 정보 표시 |
diagnostics |
오류/경고 분석 |
3. DAP 디버거 (27개 작업)
Debug Adapter Protocol을 통해 lldb, dlv, debugpy 등 다양한 디버거를 지원합니다. 27개의 디버깅 작업으로 정밀한 코드 분석이 가능합니다.
지원 디버거
- lldb: C/C++/Rust 디버깅
- dlv: Go Delve 디버거
- debugpy: Python 디버깅
4. 웹 검색 (14개 프로바이더)
arxiv PDF 검색, 14개 검색 프로바이더를 통해 최신 연구 문헌과 문서를 실시간으로 검색합니다.
5. 서브에이전트
task 팬아웃을 통해 여러 서브에이전트를 동시에 실행하여 복잡한 작업을 분산 처리합니다.
6. 코드 리뷰 (P0-P3 우선순위)
자동 코드 리뷰를 통해 P0(위급), P1(중요), P2(보통), P3(낮음) 우선순위로 문제를 분류합니다.
7. Hashline 편집
컨텐츠 해시 기반 편집으로 파일 변경을 최소화하고 안정적인 코드 수정을 보장합니다.
8. GitHub 스킴
pr://, issue://, conflict:// 스킴을 통해 GitHub PR, Issue, Conflict를 직접 조회하고 처리합니다.
9-18. 추가 핵심 기능
스트림 규칙, 네이티브 실행(ripgrep/glob), 파일 시스템, 멀티모달 지원, 커스텀 툴, 설정 관리 등 총 18가지 기능을 제공합니다.
⚙️ 기술 스택과 아키텍처
oh-my-pi는 TypeScript와 Rust로 구현되어 있습니다. Bun 런타임을 사용하여 빠른 실행 성능을 제공합니다.
| 구성 요소 | 상세 내용 |
|---|---|
| 언어 | TypeScript + Rust (~27k lines) |
| 런타임 | Bun |
| 내장 툴 | 32개 |
| LSP 작업 | 13개 |
| DAP 작업 | 27개 |
| 모델 프로바이더 | 40+ |
| GitHub Stars | 10,000+ |
| 커밋 | 6,907 |
Rust 컴포넌트는 ripgrep, glob 등 네이티브 실행을 통해 파일 시스템 작업을 최적화합니다. TypeScript는 AI 모델 통합과 툴 콜백을 처리합니다.
💡 설치 및 설정 방법
oh-my-pi는 macOS, Linux, Windows에서 설치할 수 있습니다. 각 플랫폼별 설치 방법을 알아보겠습니다.
macOS/Linux 설치
# curl 설치 스크립트
curl -fsSL https://omp.sh/install | sh
# Bun 패키지 매니저 설치
bun install -g @oh-my-pi/pi-coding-agent
Windows 설치
# PowerShell 설치 스크립트
irm https://omp.sh/install.ps1 | iex설치 전 확인 사항
- Bun 런타임이 설치되어 있어야 합니다
- Python 3.x가 필요합니다 (Python 실행 기능 사용 시)
- LSP 서버가 설치되어야 합니다 (각 언어별)
초기 설정
설치 후 AI 모델 프로바이더를 설정해야 합니다. Claude, OpenAI, Gemini 등의 API 키를 구성 파일에 추가합니다.
{
"providers": {
"anthropic": {
"apiKey": "YOUR_ANTHROPIC_API_KEY"
},
"openai": {
"apiKey": "YOUR_OPENAI_API_KEY"
},
"google": {
"apiKey": "YOUR_GOOGLE_API_KEY"
}
},
"defaultModel": "claude-sonnet-4",
"tools": {
"python": true,
"bun": true,
"lsp": true,
"dap": true
}
}
🔧 주요 기능 실전 활용법
oh-my-pi의 주요 기능을 실전에서 활용하는 방법을 알아보겠습니다.
Python 코드 자동 실행
AI가 Python 코드를 작성하고 oh-my-pi가 자동으로 실행하여 결과를 확인합니다.
LSP rename 활용
변수명을 일괄 변경하는 LSP rename 기능을 사용합니다.
# rename 요청
> Rename variable 'old_name' to 'new_name' in all references
# oh-my-pi가 LSP를 통해 모든 참조 위치를 변경GitHub PR 조회
pr:// 스킴을 통해 GitHub PR을 직접 조회합니다.
# PR 조회
> Review pr://123
# oh-my-pi가 PR #123을 조회하고 코드 리뷰 제공arxiv 논문 검색
웹 검색 기능으로 arxiv 논문을 검색하고 PDF를 분석합니다.
# arxiv 검색
> Search arxiv for "LLM reasoning benchmarks" and summarize findings
# oh-my-pi가 arxiv 검색 후 PDF 다운로드 및 분석
📊 Claude Code vs oh-my-pi 비교
oh-my-pi는 Claude Code와 유사한 기능을 제공하는 무료 대안입니다. 두 도구의 차이점을 비교해보겠습니다.
| 비교 항목 | Claude Code | oh-my-pi |
|---|---|---|
| 라이선스 | 상용 (Anthropic) | 무료 (MIT) |
| 모델 지원 | Claude만 | 40+ 모델 |
| LSP 통합 | 부분 지원 | 13개 작업 |
| DAP 디버거 | 미지원 | 27개 작업 |
| 웹 검색 | 기본 검색 | 14개 프로바이더 |
| 서브에이전트 | 미지원 | task 팬아웃 |
| GitHub 스킴 | 미지원 | pr/issue/conflict |
| 코드 리뷰 | 기본 리뷰 | P0-P3 우선순위 |
| 설치 | npm | curl/bun/ps1 |
| 소스 | 비공개 | GitHub 공개 |
oh-my-pi의 장점
- 무료 사용: MIT 라이선스로 완전 무료
- 다양한 모델: Claude, GPT, Gemini, DeepSeek 등 40+ 모델 선택 가능
- IDE 통합: LSP, DAP를 통해 IDE 수준 기능 제공
- GitHub 통합: PR, Issue, Conflict 직접 조회
- 활성 커뮤니티: 10k stars, 6,907 commits로 활발한 개발
⚠️ 한계점과 주의사항
oh-my-pi는 강력한 도구지만 몇 가지 한계점과 주의사항이 있습니다.
주의사항
- Bun 런타임 필요: Node.js 환경이 아닌 Bun이 필요합니다
- LSP 서버 설치: 각 언어별 LSP 서버를 별도 설치해야 합니다
- API 키 설정: AI 모델 API 키를 직접 구성해야 합니다
- 문서화 부족: 상용 도구보다 문서가 상세하지 않습니다
- 학습 필요: 18가지 기능을 학습하는 시간이 필요합니다
oh-my-pi는 개발자가 직접 설정하고 학습해야 하는 오픈소스 도구입니다. Claude Code와 같은 상용 도구의 편리성과 비교하면 초기 설정이 더 필요합니다.
🎯 맺음말
지금까지 oh-my-pi에 대해 알아보았습니다. oh-my-pi는 IDE 기능이 내장된 무료 터미널 AI 코딩 에이전트로, LSP 통합, DAP 디버거, 웹 검색, GitHub 스킴 등 18가지 핵심 기능을 제공합니다. 특히 TypeScript와 Rust로 구현되어 40개 이상의 모델 프로바이더를 지원하며, Claude Code의 무료 대안으로 활용할 수 있습니다.
다만 Bun 런타임, LSP 서버, API 키 설정이 필요하여 초기 설정 시간이 필요합니다. Claude Code와 같은 상용 도구의 편리성과 비교하면 학습이 필요합니다.
여러분도 한번 oh-my-pi를 GitHub에서 직접 설치해보시길 추천드리면서 저는 다음 시간에 더 유익한 정보를 가지고 다시 찾아뵙겠습니다. 감사합니다.
📚 참고 문헌 및 출처
- can1357. (2026). oh-my-pi: A coding agent with the IDE wired in. Retrieved from https://github.com/can1357/oh-my-pi
- Mario Zechner. (2026). Pi: AI Coding Agent. Retrieved from https://omp.sh
'AI 도구' 카테고리의 다른 글
| 🚀 Qwen3.7-Plus: 비전과 코드를 한 번에 처리하는 알리바바 최신 멀티모달 출시 (0) | 2026.06.04 |
|---|---|
| 🚀 Microsoft Scout 완벽 분석: 상시 가동 Autopilot AI 비서의 모든 것 (0) | 2026.06.04 |
| 🆓 Odysseus: GitHub 26K 자체 호스팅 AI 워크스페이스로 이메일, 캘린더, 문서, 노트 통합 관리 (0) | 2026.06.02 |
| 🆓 GitLab Duo 무료 트라이얼: Claude Opus 4.8, GPT-5.5 AI 모델 무료 활용 가이드 (0) | 2026.06.02 |
| 🆓 NanoClaw: 15개 메시징 앱 연동 AI 어시스턴트 완벽 가이드 (0) | 2026.05.31 |
