작업 폴더에서 pi를 실행하면 대화형 화면이 열립니다. Pi는 이 폴더를 기준으로 파일·지침·설정을 찾고, 저장된 세션도 폴더별로 묶습니다. 처음 방문한 폴더라면 프로젝트 신뢰 판정을 먼저 물을 수 있습니다.

화면은 세 부분으로 읽힙니다. 대화 기록(transcript)에는 내 프롬프트와 Pi의 응답, 도구 호출과 결과, 오류가 남습니다. 편집기에는 프롬프트와 명령을 입력합니다. 하단 바에는 현재 폴더, 세션, 모델, 컨텍스트 사용량, 누적 사용량과 비용이 표시됩니다.

프롬프트 입력과 파일 포함

• Enter: 입력한 프롬프트 전송
• Shift+Enter: 줄바꿈
• Ctrl+G: 외부 편집기에서 긴 프롬프트 작성

파일이거나 이미지를 포함하는 방법:

• @ 입력: 파일 검색해 프롬프트에 추가
• Tab: 경로 자동 완성
• 이미지 붙여넣기 또는 터미널로 드래그 (지원되는 터미널에서)

Pi의 작업을 따라가기

Pi는 각 도구 호출과 결과를 즉시 화면에 보여 줍니다. Ctrl+O로 도구 출력을 펼치거나 접고, Ctrl+T로 thinking 블록 표시를 켜거나 끕니다. 시작 헤더에는 Pi가 로드한 지침과 자원 목록이, 편집기 테두리 색은 현재 thinking 단계를, 하단 바는 모델이 컨텍스트를 사용할 때마다 갱신됩니다.

작업 도중에 방향 바꾸기

Pi가 일하는 중에도 추가 입력을 보낼 수 있습니다.

원하는 것	동작
현재 작업 조정	메시지를 입력하고 Enter (조향)
현재 작업 뒤에 추가 작업 예약	메시지를 입력하고 Alt+Enter (후속)
대기 중인 메시지를 편집기로 되돌리기	Alt+Up
현재 작업 중단	Escape

Enter로 보낸 메시지는 현재 응답과 그 도구 호출이 끝난 뒤 다음 응답을 이끕니다. Alt+Enter로 보낸 후속 메시지는 Pi가 현재 작업을 모두 마친 뒤에 들어갑니다. 중단하면 대기 중이던 메시지는 편집기로 돌아옵니다. Windows Terminal은 일부 Alt 단축키를 예약하므로 대체 키를 터미널 설정 문서를 확인합니다.

모델과 설정 바꾸기

/를 입력하면 사용 가능한 명령 검색 창이 열립니다. 자주 쓰는 명령은 다음입니다.

• /model 모델 선택 (Ctrl+L도 같은 선택기를 열음)
• /thinking 현재 모델의 추론 강도 설정 (Shift+Tab으로 지원 단계 순환)
• /login, /logout 제공자 인증 관리
• /settings 일반 환경설정

프롬프트 템플릿, 스킬, 확장은 같은 메뉴에 명령을 추가합니다. 전체 명령 목록은 뒤의 표를 봅니다.

세션 명령 요약

Pi는 세션 저장을 끄지 않는 한 자동 저장합니다.

• /new 새 세션 시작
• /resume 다른 저장 세션 열기
• /name 현재 세션에 알아보기 쉬운 이름 붙이기
• /session 세션 파일, ID, 메시지 수, 토큰 사용량, 비용 표시
• /tree, /fork, /clone 다른 접근을 탐구 (세션 관리 글 참조)
• /compact 모델에게 보내는 대화 기록 줄이기

나간 뒤에는 같은 폴더에서 pi --continue로 가장 최근 세션을 이어갑니다.

셸 명령 실행하기

명령 앞에 !를 붙여 실행하면 그 출력이 대화에 포함됩니다.

!git status

출력을 모델에게 보내지 않고 실행만 하려면 !!를 씁니다.

결과 복사·내보내기·공유

• Ctrl+X 또는 /copy: 마지막 어시스턴트 응답 복사
• /export: 세션을 HTML 또는 JSONL로 저장
• /share: 세션을 업로드하고 뷰어 링크 받기 (Radius 인증 시 조직 공개 아티팩트, 아니면 GitHub CLI로 비공개 gist 생성)

공유·내보내기 대상 세션에는 프롬프트, 도구 출력, 파일 내용, 대화 중 노출된 자격 증명이 들어 있을 수 있습니다. 반드시 먼저 검토하라는 것이 공식 안내입니다.

터미널 조정과 진단

기본인 전체화면 모드는 편집기와 상태 영역을 고정하고 대화 기록을 터미널 창 안에서 스크롤합니다. 일반 모드는 터미널 고유의 스크롤백을 사용합니다. /settings나 --tui-mode로 바꿉니다. mouse 입력, 단축키, 인라인 이미지 지원은 터미널마다 다릅니다. /hotkeys로 현재 세션에 활성인 단축키를 확인할 수 있습니다.

렌더링이나 대화 상태를 디버그할 때는 /debug를 실행합니다. 에이전트 디렉터리의 pi-debug.log에 렌더링된 터미널 라인과 현재 세션 메시지가 기록됩니다. 공유 전에 반드시 확인하세요.

내장 슬래시 명령 참고

영역	명령
모델·설정	/settings /model /thinking /scoped-models /login /logout /llama
세션·컨텍스트	/new /resume /name /session /tree /fork /clone /compact /import
내보내기·공유	/copy /export /share /bug
실행·프로젝트	/trust /mcp /reload /hotkeys /changelog /quit

확장은 인자와 완성을 갖춘 자체 명령을 등록하고, 프롬프트 템플릿은 템플릿 이름 그대로, 스킬은 /skill:이름 형태로 명령 메뉴에 나타납니다. 자원을 추가·수정했다면 /reload를 실행합니다.