테마 전환
Pi (번역일자: 2026-11-07)
가장 많은 기능이 아니라, 내 워크플로에 맞는 기능만.
터미널에서 동작하는 최소·확장형 코딩 에이전트 Pi — 설계 철학과 동작 원리부터 설치·사용법, MCP와 확장·스킬로 나를 맞추는 메뉴얼, TypeScript SDK 예제까지의 기록을 정리합니다.
요약
터미널에서 동작하는 최소·확장형 코딩 에이전트 하네스(GUI 가능), 클로드 등 유료 모델 중 하나를 선택하거나 로컬 모델 사용 가능
사용 후기
linux shell에 익숙하신분이 사용하기 좋아요. (GUI도 가능) 완전 오픈소스에다가 미니멀리즘을 지향해서 원하는 확장만 추가로 설치할 수 있었습니다. 하네스에 기본적으로 코드작성, 편집 툴이 붙어있어서 그냥 사용하셔도 되고 대화형, 단일 호출 다 돼서 원하는대로 작업하기 좋았습니다!
라이선스
원저작자: Mario Zechner. earendil-works/pi 저장소에서 개발·배포하며, 저장소의 저작권 표기와 패키지 저자가 모두 Mario Zechner로 기록되어 있습니다. 터미널 CLI는 npm의 @earendil-works/pi-coding-agent 패키지로 배포됩니다.
저장소 전체는 MIT License이며, 최상위 LICENSE에 Copyright (c) 2025 Mario Zechner로 기록되어 있습니다. npm 패키지의 license 필드도 MIT이고, 문서·예제 확장에는 별도 라이선스가 선언되지 않아 같은 MIT 라이선스가 적용됩니다.
NOTICE: Pi 원본 저장소 최상위에는 별도의 NOTICE 파일이 확인되지 않습니다. 다만 동봉된 서드파티 자료는 고지 파일이 따로 있습니다. packages/mcp/THIRD_PARTY_NOTICES의 ModelContextProtocol TypeScript SDK(MIT, © 2024 Anthropic, PBC), packages/schema/THIRD_PARTY_NOTICES의 TypeBox(MIT, © 2017-2026 Haydn Paterson), 자체 호스팅 웹 UI 프로토타입인 apps/p2가 불러 쓰는 Ghostty 터미널 라이브러리(MIT, © 2024 Mitchell Hashimoto 및 기여자)도 같은 방식으로 동봉되어 있습니다. MIT가 아닌 자료도 있는데, /export로 세션을 HTML로 내보낼 때 쓰는 highlight.js v11.9.0은 BSD-3-Clause 라이선스를 따릅니다. 이 자료의 전부 또는 상당 부분을 복제·수정·재배포할 경우 원저작권 표시와 각 라이선스 고지를 유지해야 하며, 이는 Pi의 기본 MIT 라이선스에는 영향을 주지 않습니다.
마인드맵으로 둘러보기
Pi에서 소개·개념, 사용법, 메뉴얼, SDK 예제로 이어지는 전체 글의 흐름을 살펴보세요. 글 노드를 펼치면 해당 글의 세부 목차가 나타납니다.
노드를 눌러 가지를 펼치거나 접을 수 있습니다. ↗는 글로, 마지막 단계의 목차는 해당 절로 이동합니다. 넓은 지도는 좌우·상하로 스크롤하세요.
전체 글 한눈에 보기
소개·개념 2편, 사용법 5편, 메뉴얼 5편, SDK 예제 1편을 학습 순서대로 읽을 수 있습니다. 글 제목을 누르면 본문으로, 세부 목차의 항목을 누르면 해당 절로 바로 이동합니다.
소개 · 개념
Pi 코딩 에이전트 소개: 직접 고쳐 쓰는 최소 에이전트 하네스
내장 기능을 덜어내고 확장·스킬·패키지로 자기 도구를 직접 조립하는 Pi의 설계 철학을 읽습니다.
Pi의 동작 원리: 에이전트 루프, 컨텍스트, 세션 트리
에이전트 루프, 컨텍스트 조립, 트리로 갈라지는 세션 저장까지 Pi의 뼈대를 이해합니다.
사용법
설치와 퀵스타트: 네 단계로 첫 작업까지
설치 세 가지 방법, 모델 연결, 첫 작업 지시, 커스터마이징 수단 선택표까지 네 단계로 따라갑니다.
대화형 사용 안내: 입력, 명령, 작업 도중 방향 잡기
터미널 화면 읽기, 파일 포함, 작업 중 조향과 후속, 셸 명령 실행, 결과 복사·내보내기를 다룹니다.
세션과 컨텍스트 관리: 이어하기, 갈라치기, 압축
이어하기와 갈라치기(tree·fork·clone), 컨텍스트 압축, 저장 위치 제어와 내보내기 실무입니다.
설정과 모델 선택: 디렉터리 구조, 설정, 제공자
에이전트 디렉터리와 프로젝트 .pi 구조, 컨텍스트 파일, 모델·제공자·호환 엔드포인트 연결을 정리합니다.
안전하게 실행하기: 프로젝트 신뢰와 격리
프로젝트 신뢰가 통제하는 것과 한계, 격리 실행 패턴 세 가지와 실전 안전 수칙을 살펴봅니다.
메뉴얼 · 확장
Pi 자동화하기: print, JSON, RPC 모드
print, JSON, RPC 모드로 스크립트와 파이프라인에서 Pi를 쓰는 법과 이벤트 스트림 판독 요령입니다.
MCP 서버 연결하기
MCP 서버 추가와 설정 파일, OAuth 로그인, 도구 노출 제어, 진단 명령을 실무 중심으로 정리합니다.
TypeScript로 확장 만들기
이벤트 가로채기, 커스텀 도구, 명령 등록으로 만드는 확장 구조와 저장소의 예제 확장 모음입니다.
스킬과 프롬프트 템플릿
필요할 때만 로드되는 스킬과 `/` 명령이 되는 프롬프트 템플릿의 작성법·로드 방식을 다룹니다.
테마와 Pi 패키지
테마 파일 형식과 선택 방법, 확장·스킬·템플릿·테마를 한 단위로 배포하는 Pi 패키지 만들기입니다.
예제
TypeScript SDK로 Pi 내장하기 (예제 14종)
TypeScript SDK로 앱 안에 Pi를 내장하는 최소 예제부터 세션 제어, 저장소의 예제 14종까지 살펴봅니다.