pisesh: pi 코딩 에이전트 세션을 즐겨찾기하고 검색하는 TUI 도구
pi는 터미널 기반 AI 코딩 에이전트입니다. 하지만 세션이 많아지면 문제가 생깁니다. 작업 디렉토리마다 폴더를 나눠서 작업해도 50개씩 쌓이는 세션은 시간순으로 쭉 나열될 뿐, 제목도 없고 태그도 없어서 "인증 버그를 고친 세션"이 어느 것인지 찾기 어렵습니다. pisesh는 이 문제점을 해결하는 단일 파일 Node.js 스크립트입니다.
pi의 세션 관리 한계
pi에는 pi --resume 명령이 있습니다. 이 명령은 모든 세션을 시간순으로 나열해주지만, 몇 가지 한계가 있습니다:
• 제목이나 태그가 없어서 어떤 세션인지 구별이 힘니다
• 프로젝트별로 세션을 구분할 수 없습니다
• 긴-running 스레드를 다시 열었을 때 잘못된 세션에이 섞여 들어갈 수 있습니다
pisesh가 해결하는 방법
pisesh는 약 600줄의 단일 파일 Node.js 스크립트로, pi가 제공하지 않는 세 가지 핵심 기능을 추가합니다.
즐겨찾기 기능
별표 키(f 또는 Space)를 눌러 세션을 즐겨찾기로 표시할 수 있습니다. 즐겨찾기는 ~/.pi/agent/favorites.json 파일에 전역으로 저장됩니다. 여러 프로젝트에서 자주 돌아가는 스레드를 영구적으로 표시해 둘 수 있습니다.
빠른 검색
슬래시 키(/)를 누르면 세션 ID, 프로젝트 이름, 첫 번째 사용자 프롬프트 안에서 검색할 수 있습니다. 타이브스탬프를 추측해서 세션을 찾는 수고가 사라집니다.
[NOW] 배지
현재 연결된 세션에는 초록색 [NOW] 배지가 표시됩니다. 어떤 세션에서 작업 중인지 한눈에 알 수 있습니다.
설치 방법
권장 방법: pi 확장자로 설치
pi install npm:pisesh이렇게 하면 CLI와 /sesh 슬래시 명령이 함께 설치됩니다. pi 안에서 /sesh를 입력하면 pisesh TUI가 실행됩니다.
독립형 CLI만 설치
npm install -g piseshpisesh슬래시 바인딩이 필요 없이 독립형 명령으로만 사용하고 싶을 때 이 방법을 선택합니다.
소스에서 빌드
git clone https://github.com/Blue-B/pisesh.gitcd piseshnpm linkpisesh --help주요 키 바인딩
| 키 | 동작 |
|---|---|
| ↑↓ 또는 j/k | 커서 이동 |
| Tab 또는 h/l | 탭 전환 (★ 즐겨찾기 → 오늘 → 전체) |
| f 또는 Space | 선택한 세션 즐겨찾기/해제 |
| Enter | 선택한 세션으로 재개 (pi --session 실행) |
| d | 세션 상세 정보 보기 |
| / | 세션 검색 |
| Esc | 검색 초기화 후 종료 |
| q 또는 Ctrl-C | 종료 (터미널 복원) |
기술 구현
pisesh는 외부 의존성 없이 Node.js 내장 모듈(fs, path, os, child_process, readline)만 사용합니다. TUI 렌더링은 blessed나 ink 같은 라이브러리 대신 순수 ANSI 이스케이프 시퀀스를 사용합니다. 이 방식은 vim, less, htop와 동일하며, 종료 시 터미널이 바이트 단위로 복원됩니다.
CJKaware 렌더링도 중요한 특징입니다. 한국어, 중국어, 일본어 문자는 터미널에서 2셀 폭을 차지하는데, pisesh는 표시 너비(UAX #11 East Asian Width)를 계산해서 컬럼이 깨지지 않도록 합니다. "안녕하세요 세상"이라는 프롬프트도 "hello world"와 동일한 레이아웃을 유지합니다.
세션 복구 동작
pi 세션 A에서 /sesh를 입력하면:
1. pi의 TUI가 일시 정지됩니다
2. pisesh가 PISESH_CURRENT_SESSION=A 환경 변수로 실행됩니다
3. 세션 B에서 Enter를 누르면 pi --session B가 실행됩니다
4. 세션 B 작업이 끝나면 q를 눌러하고 pi 세션 A로 돌아옵니다
세션 A의 상태가 완전히 유지되므로 컨텍스트 손실 없이 멀티세션 작업을 할 수 있습니다.
저장 위치
| 데이터 | 위치 |
|---|---|
| 즐겨찾기 | ~/.pi/agent/favorites.json |
| 세션 파일 | ~/.pi/agent/sessions/ |
pisesh는 세션 파일을 읽기 전용으로만 사용합니다. 즐겨찾기 파일 하나만 백업하면 모든 중요 세션을 보존할 수 있습니다.
로드맵
완료된 기능: 탭, 즐겨찾기, 검색, alt-screen, CJK 너비, [NOW] 배지, pi /sesh
개발 중인 기능:
• n/N 키로 이전/다음 검색 결과로 이동
• 일치하는 문자열 노란색 하이라이트
• 오늘/어제/이번 주 필터
Ideas:
• 로컬 모델로 첫 N개 사용자 프롬프트 요약해서 제목을 자동으로 생성
• 즐겨찾기 세션을 단일 번들로 내보내기
• 커스텀 라벨/이름 지정 기능
함께 보면 좋은 도구
• agf: AI 코딩 에이전트 세션을 한 곳에서 관리하는 TUI
• agent-of-empires: tmux와 git Worktree를 활용한 세션 관리자
pisesh는 개발자들의 واقع적인 문제에서 출발해서 최소한의 코드로 최대의 가치를 제공하는 도구입니다. pi 사용 시 세션 관리에 어려움을 겪고 있다면 설치해보세요.
📚 출처
📚 출처
'AI 뉴스' 카테고리의 다른 글
| Show GN: Nomad AI - 나만의 온디바이스 여행 도우미 완벽 가이드 (0) | 2026.06.01 |
|---|---|
| 도메인 전문성은 언제나 진짜 해자였다 (0) | 2026.06.01 |
| OpenRouter, 1억 1,300만 달러 Series B 유치 — 개발자가 반드시 알아야 할 핵심 정리 (0) | 2026.06.01 |
| Anthropic, OpenAI를 제치고 가장 가치 있는 AI 스타트업이 됨 (0) | 2026.06.01 |
| Anthropic, OpenAI를 제치고 가장 가치 있는 AI 스타트업이 됨 (0) | 2026.06.01 |