Pi 운영 중

Pi(Agent Harness)는 Mario Zechner가 출시한 초간결 오픈 소스 터미널 프로그래밍 Agent이며, OpenClaw의 하위 Coding Agent이기도 합니다. 도구는 모델에 read, write, edit, bash 네 가지 기본 도구만 제공하고, 시스템 프롬프트는 1000 token 미만이며, 나머지 기능은 모두 TypeScript 확장에 맡깁니다. Pi는 15개 이상의 모델 제공업체, 트리형 분기 세션, 제공업체 간 모델 전환을 지원합니다.

WeChat에서 팔로우한 후 “开源”에 답장하여 AI 오픈 소스 프로젝트 교류 그룹에 가입
초간결 도구 모음: 기본적으로 모델에 read, write, edit, bash 네 가지 도구만 제공하며, 검색 등의 작업은 모델이 grep/find를 직접 사용해 해결합니다. 시스템 프롬프트는 1000 token 미만입니다.
다중 모델 연동: Anthropic, OpenAI, Kimi, DeepSeek, MiniMax 등을 포함한 15개 이상의 제공업체를 기본 지원하며, OAuth 구독 로그인과 API Key 두 가지 방식을 지원합니다.
트리형 세션 기록: 세션은 트리 구조로 저장되므로 언제든 임의의 기록 노드로 돌아가 다시 질문하거나 분기해 실험할 수 있으며, 모든 분기는 하나의 파일에 함께 저장됩니다.
제공업체 간 모델 전환: 세션 중 /model 또는 Ctrl+L을 사용해 서로 다른 제공업체의 모델로 전환할 수 있으며, 컨텍스트가 자동으로 인계되고 변환됩니다.
네 가지 실행 모드: 대화형 TUI, Print/JSON 스크립트 모드, RPC 프로토콜, Node.js SDK를 제공하여 일상적인 코딩부터 프로그램 통합까지 다양한 상황을 지원합니다.
확장 기능 사용자 지정: TypeScript 확장 모듈을 디렉터리에 넣으면 핫 로딩되며, 사용자 지정 도구와 명령을 등록하고 이벤트를 가로챌 수 있습니다. Pi가 실행 중에 스스로 확장을 작성하게 할 수도 있습니다.
Skills 및 Prompt 템플릿: Agent Skills 표준을 지원하며, Markdown 파일을 매개변수가 있는 / 명령으로 바로 변환할 수 있습니다.
커뮤니티 패키지 생태계: 확장, Skills, 템플릿, 테마를 Pi packages로 패키징할 수 있으며, pi install npm:xxx 또는 git 저장소를 통해 한 번에 설치하고 공유할 수 있습니다.
기존 설정과의 호환: 디렉터리 트리를 자동으로 검색하여 AGENTS.md와 CLAUDE.md를 인식하므로 기존 Claude Code 설정을 마이그레이션할 필요가 없습니다.
컨텍스트 엔지니어링: SYSTEM.md로 시스템 프롬프트를 덮어쓰고, 자동 Compaction 요약과 동적 컨텍스트 주입을 지원하여 컨텍스트 창에 들어가는 각 token을 정밀하게 제어할 수 있습니다.

설치: 터미널에서 npm install -g --ignore-scripts @earendil-works/pi-coding-agent를 실행하거나 curl -fsSL https://pi.dev/install.sh | sh를 실행하여 Pi를 설치합니다.
시작: 설치가 완료되면 터미널에 pi를 입력하여 대화형 TUI 인터페이스로 들어갑니다.
로그인 설정: 처음 사용할 때 /login을 실행하고 OAuth 구독 로그인 또는 API Key 입력을 선택하여 모델 제공업체를 설정해야 합니다.
프로젝트 진입: 프로젝트 디렉터리로 이동한 후 pi를 입력하면 Pi가 현재 디렉터리와 상위 디렉터리의 AGENTS.md 또는 CLAUDE.md를 컨텍스트로 자동 로드합니다.
대화 시작: 대화형 인터페이스에서 자연어로 요구 사항을 설명하고, @로 파일을 퍼지 검색하며, !로 Shell 명령을 실행하고, Ctrl+V로 이미지를 붙여넣습니다.
모델 전환: 모델을 변경하려면 언제든 /model을 입력하거나 Ctrl+L을 눌러 서로 다른 제공업체의 모델로 전환할 수 있으며, 컨텍스트가 자동으로 인계됩니다.
트리형 되돌리기: /tree 명령으로 트리형 세션 기록을 확인하고, 임의의 노드로 돌아가 다시 질문하거나 분기해 실험할 수 있습니다.
확장 기능: 기능을 확장하려면 ~/.pi/agent/extensions/ 디렉터리에 TypeScript 확장 모듈을 작성하고, 저장한 후 /reload를 입력하여 핫 로딩할 수 있습니다.
내보내기 및 공유: 세션이 끝난 후 /export로 HTML로 내보내거나 /share로 GitHub Gist 공유 링크를 생성할 수 있습니다.
종료 및 이어하기: Ctrl+C 또는 Ctrl+D를 눌러 현재 세션을 종료하고, 다음에 pi -c를 사용하여 이전 대화를 계속할 수 있습니다.

초간결하고 효율적: 시스템 프롬프트와 도구 정의가 1000 token 미만이며 모델에 네 가지 기본 도구만 제공하므로 응답 속도가 매우 빠릅니다.
정밀한 컨텍스트 제어: SYSTEM.md, AGENTS.md, 동적 컨텍스트 주입 및 자동 Compaction을 지원하여 각 token이 컨텍스트에 들어가는 방식을 직접 결정할 수 있습니다.
강력한 확장성: TypeScript 확장은 핫 로딩으로 즉시 적용되며, Pi가 실행 중에 스스로 확장을 작성하게 할 수도 있습니다. 공식에서 제공하지 않는 기능은 커뮤니티 패키지로 보완할 수 있습니다.
트리형 세션 기록: 세션을 트리 구조로 저장하여 언제든 임의의 노드로 돌아가 다시 분기하고 실험할 수 있으므로 선형 대화의 매몰 비용을 줄입니다.
제공업체 간 원활한 전환: 15개 이상의 제공업체를 기본 지원하며, 세션 중에도 언제든 다른 제공업체의 모델로 전환할 수 있고 컨텍스트가 자동으로 인계되고 변환됩니다.
마이그레이션 비용 제로: CLAUDE.md와 AGENTS.md를 자동으로 인식하며, Skills 표준은 Claude Code 및 Codex와 호환되므로 기존 설정을 그대로 재사용할 수 있습니다.
중국산 모델 친화적: DeepSeek, Kimi, 智谱, Qwen, MiniMax, MiMo 등 중국산 모델을 기본 지원하고 중국 지역 노드도 별도로 구성되어 있습니다.
완전한 MIT 오픈 소스: 코드가 모두 공개되어 있고 공급망 보안이 hardened 상태이며, 커뮤니티에서 Go, Rust, Python 등 여러 포팅 버전이 파생되었습니다.
네 가지 실행 모드: 대화형 TUI, Print/JSON, RPC, SDK를 통해 일상적인 코딩부터 기업 통합까지 모든 상황의 요구를 충족합니다.
자기 설명 기능: Pi는 자신의 기능과 문서를 설명할 수 있으며, 문서 검색과 설정 작성까지 직접 도와 진입 장벽을 낮춥니다.

프로젝트 공식 웹사이트: https://pi.dev/
GitHub 저장소: https://github.com/earendil-works/pi

빠른 스크립트 및 프로토타입 개발: 터미널에서 자연어로 스크립트를 직접 생성, 디버깅 및 실행하고, 트리형 세션으로 다양한 구현 방식을 빠르게 실험할 수 있습니다.
코드베이스 리팩터링 및 유지 관리: Pi의 코드 편집 기능과 모델 간 전환 기능을 활용해 대규모 프로젝트에서 일괄 리팩터링을 수행하고, AGENTS.md를 통해 프로젝트 규칙을 축적할 수 있습니다.
사용자 지정 개발 워크플로: TypeScript 확장을 작성하여 Pi를 팀 또는 개인에 맞는 전용 도구 체인으로 바꿀 수 있습니다. 예를 들어 자동 코드 리뷰, 문서 생성, 특정 프레임워크 스캐폴딩 등을 구현할 수 있습니다.
오픈 소스 협업 및 지식 공유: /share로 GitHub Gist를 내보내거나 /export로 HTML을 생성하여 전체 디버깅 및 개발 과정을 협업자와 공유하거나 기술 블로그에 활용할 수 있습니다.
원격 서버 및 컨테이너화 개발: SSH 서버 또는 Docker 컨테이너에서 Pi를 실행하고 tmux와 함께 사용해 백그라운드 영속 세션을 구현할 수 있어, 클라우드 개발과 CI/CD 파이프라인 통합 등 그래픽 인터페이스가 없는 환경에 적합합니다.