이전 글에서는 pi package의 기본 설치, 확인, 업데이트, 제거 방법을 정리했습니다. 이제 실제로 설치해서 쓸 만한 package를 봅니다.
이번 글에서는 범용성이 높은 생산성 기본 도구를 다룹니다.
이 글에서 다룰 package
pi install npm:pi-resource-center
pi install npm:@eko24ive/pi-ask
pi install npm:pi-docparser
역할은 다음과 같습니다.
| package | 역할 |
|---|---|
pi-resource-center |
package, extension, skill, prompt, theme 탐색과 관리 |
@eko24ive/pi-ask |
에이전트가 사용자에게 구조화된 질문을 하게 함 |
pi-docparser |
PDF, Office 문서, 이미지, CSV 등을 파싱 |
1. pi-resource-center
설치
pi install npm:pi-resource-center
설치 후 pi 안에서 다시 읽습니다.
/reload
사용
리소스 브라우저를 엽니다.
/resource
카테고리별로 바로 열 수도 있습니다.
/resource packages
/resource skills
/resource extensions
/resource prompts
/resource themes
리소스 목록을 다시 스캔하려면 다음 명령을 사용합니다.
/resource sync
언제 유용한가
pi를 쓰다 보면 package, extension, skill, prompt가 점점 늘어납니다. 이때 설정 파일을 직접 열어보는 것보다 /resource로 확인하는 편이 쉽습니다.
특히 이런 상황에서 유용합니다.
- 설치된 package 목록을 보고 싶을 때
- 특정 extension을 켜거나 끄고 싶을 때
- project scope와 user scope를 구분하고 싶을 때
- package를 추가하거나 제거하는 흐름을 TUI에서 보고 싶을 때
처음 pi package를 쓰기 시작한다면 가장 먼저 설치해볼 만한 도구입니다.
2. @eko24ive/pi-ask
설치
pi install npm:@eko24ive/pi-ask
GitHub에서 설치할 수도 있습니다.
pi install git:github.com/eko24ive/pi-ask
설치 후 /reload하거나 pi를 재시작합니다.
사용
설정 화면을 엽니다.
/ask-settings
에이전트가 일반 텍스트로 질문을 남겼다면, 마지막 assistant 메시지에서 질문을 추출해 ask UI로 열 수 있습니다.
/answer
이전에 만든 answer form을 다시 열 수도 있습니다.
/answer:again
실제 ask_user form을 다시 재생하려면 다음 명령을 사용합니다.
/ask:replay
언제 유용한가
LLM 에이전트가 애매한 요구사항을 만나면 추측할 때가 많습니다. pi-ask는 이 순간에 에이전트가 사용자에게 구조화된 질문을 하도록 도와줍니다.
예를 들어 이런 질문을 터미널 UI로 받을 수 있습니다.
이 글의 대상 독자는 누구인가요?
1. 완전 초보자
2. LLM 코딩 도구를 이미 써본 개발자
3. 팀 도입을 검토하는 리드 개발자
이런 작업에 특히 좋습니다.
- 구현 방향이 여러 개일 때
- 글의 톤, 대상 독자, 범위를 정해야 할 때
- 파일 삭제나 이름 변경처럼 사용자 확인이 필요할 때
- 에이전트가 요구사항을 추측하면 위험할 때
설치 확인
설치 후 아래 명령이 동작하면 기본 확인은 끝입니다.
/ask-settings
3. pi-docparser
설치
pi install npm:pi-docparser
GitHub에서 설치할 수도 있습니다.
pi install git:github.com/maxedapps/pi-docparser
설치 후 /reload하거나 pi를 재시작합니다.
사용
문서 파싱에 필요한 host dependency를 확인합니다.
/docparser:doctor
특정 파일을 기준으로 확인할 수도 있습니다.
/docparser:doctor @./slides.pptx
문서를 요약하고 싶으면 자연어로 요청합니다.
@./docs/report.pdf 이 PDF 내용을 요약해줘.
이미지나 스캔 문서에서 OCR이 필요하면 이렇게 요청할 수 있습니다.
@./scans/receipt.jpg 이 이미지에서 텍스트를 추출해줘.
지원 형식
| 종류 | 예시 |
|---|---|
| 문서 | PDF, DOCX, ODT, RTF |
| 발표자료 | PPT, PPTX, ODP |
| 스프레드시트 | XLS, XLSX, CSV, TSV |
| 이미지 | PNG, JPG, TIFF, WebP, SVG |
Office 문서나 이미지 변환은 환경에 따라 LibreOffice, ImageMagick, Ghostscript가 필요할 수 있습니다. 문제가 생기면 먼저 /docparser:doctor를 실행합니다.
언제 유용한가
교육 자료, 보고서, 문제지, 회의 자료를 자주 다루는 사람에게 유용합니다.
- PDF 강의자료 요약
- DOCX 문서 검토
- PPTX 발표자료 구조 추출
- CSV/XLSX 데이터 확인
- 이미지 기반 문제지 OCR
추천 설치 조합
처음에는 이 세 개를 기본 생산성 조합으로 볼 수 있습니다.
pi install npm:pi-resource-center
pi install npm:@eko24ive/pi-ask
pi install npm:pi-docparser
설치 후 확인합니다.
/resource
/ask-settings
/docparser:doctor
다만 모든 프로젝트에서 문서 파싱이 필요한 것은 아닙니다. pi-docparser는 문서 자료를 자주 다루는 프로젝트에만 -l로 설치해도 됩니다.
pi install npm:pi-docparser -l
AI 코딩 도구와 함께 쓰는 프롬프트
Pi처럼 가벼운 에이전트 하네스를 쓸 때는 세션, 프로젝트 컨텍스트, package 설치 범위를 분명히 하는 것이 중요합니다. 중요: 네트워크 요청, sudo, 시스템 경로 접근이 필요한 package는 실행 전 별도 확인을 받으세요.
현재 프로젝트에서 pi를 실행해도 되는지 확인해줘.
프로젝트 폴더, AGENTS.md 같은 컨텍스트 파일, 현재 세션 목적을 먼저 설명하고 파일 수정은 하지 마.
이 pi package를 설치해도 되는지 검토해줘.
공식 출처, 설치 위치, 필요한 권한, 네트워크 요청 여부, 제거 방법을 먼저 설명하고, 설치 명령은 내가 허락하기 전에는 실행하지 마.
웹 탐색이나 고급 package를 붙일 때는 “민감 정보 접근 여부와 외부 요청이 발생하는지 먼저 알려줘”라고 덧붙이세요.
한 번에 정리
| 목적 | 설치 | 사용 |
|---|---|---|
| package와 리소스 관리 | pi install npm:pi-resource-center |
/resource |
| 구조화된 질문 UI | pi install npm:@eko24ive/pi-ask |
/ask-settings, /answer |
| 문서 파싱과 OCR | pi install npm:pi-docparser |
/docparser:doctor, 문서 파일 요청 |
다음 글에서는 웹 탐색 package와, 조금 더 고급 운영에 가까운 package 선택 기준을 정리합니다.
💬 댓글
이 글에 대한 의견을 남겨주세요