Pi 문서

Pi는 터미널에서 동작하는 경량 coding Agent 프레임워크입니다. 핵심은 작게 유지하면서 TypeScript 확장, Skills, Prompt Templates, Themes, Pi Packages로 확장할 수 있습니다.

npm으로 Pi를 설치합니다.

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

--ignore-scripts는 설치 중 종속성 수명 주기 스크립트를 비활성화합니다. 일반적인 npm 설치에 Pi 설치 스크립트는 필요하지 않습니다.

Linux 또는 macOS에서는 설치 프로그램을 사용할 수도 있습니다.

curl -fsSL https://pi.dev/install.sh | sh

curl 설치 프로그램이나 npm으로 설치한 Pi 자체를 제거하려면 npm을 사용합니다.

npm uninstall -g @earendil-works/pi-coding-agent

pnpm, Yarn 또는 Bun으로 설치했다면 해당 전역 제거 명령을 사용하세요. pnpm remove -g @earendil-works/pi-coding-agent, yarn global remove @earendil-works/pi-coding-agent, bun uninstall -g @earendil-works/pi-coding-agent를 사용할 수 있습니다.

그런 다음 프로젝트 디렉터리에서 실행합니다.

pi

구독 Provider는 /login으로 인증하거나, pi를 시작하기 전에 ANTHROPIC_API_KEY 같은 API key를 설정하세요.

전체 첫 실행 과정은 Quickstart를 참조하세요.

• Quickstart - 설치, 인증, 첫 세션 시작.
• Using Pi - 대화형 모드, slash commands, context files, CLI 참조.
• Providers - 내장 Provider의 구독 및 API key 설정.
• llama.cpp - 로컬 라우터를 실행하고 /llama로 모델 관리.
• Security - 프로젝트 신뢰, sandbox 경계, 취약점 보고.
• Containerization - Gondolin, Docker 또는 OpenShell로 pi를 sandbox에서 격리.
• Settings - 전역 및 프로젝트 설정.
• Keybindings - 기본 단축키 및 사용자 지정 키 바인딩.
• Sessions - 세션 관리, 분기, 트리 탐색.
• Compaction - 컨텍스트 압축 및 브랜치 요약.

• Extensions - 도구, 명령, 이벤트, 사용자 지정 UI용 TypeScript 모듈.
• Skills - 재사용 가능한 온디맨드 기능을 제공하는 Agent Skills.
• Prompt templates - slash commands에서 확장되는 재사용 가능한 프롬프트.
• Themes - 내장 및 사용자 지정 터미널 테마.
• Pi packages - 확장, Skills, 프롬프트, 테마를 묶어 공유.
• Custom models - 지원되는 Provider API에 모델 항목 추가.
• Custom providers - 사용자 지정 API 및 OAuth 흐름 구현.

• SDK - Node.js 애플리케이션에 pi를 임베드.
• RPC mode - stdin/stdout JSONL을 통해 연동.
• JSON event stream mode - 구조화된 이벤트를 출력하는 print mode.
• TUI components - 확장용 사용자 지정 터미널 UI 구축.

• Environment variables - bash 도구에서 사용할 수 있는 Pi 프로세스 구성 및 세션 메타데이터.
• Session format - JSONL 세션 파일 형식, 항목 유형, SessionManager API.

• Windows
• Termux on Android
• tmux
• Terminal setup
• Shell aliases

• Development - 로컬 설정, 프로젝트 구조 및 디버깅.