pi-treebase: Git Rebase 방식의 LLM 세션 히스토리 관리 도구

섹션별 상세

기존의 복잡한 LLM 대화 세션을 효율적으로 정리하기 위해 Git의 대화형 리베이스 개념을 차용했다. 사용자는 /treebase 명령을 통해 히스토리를 재배치할 목적지를 선택하고 편집기를 통해 각 항목의 처리 방식을 결정한다.

근거

pi-treebase는 base /tree 기능과 git rebase --interactive 기능을 결합했다. — README.md의 Description 섹션

사용자는 각 히스토리 항목에 대해 Pick, Summarize(Low/High), Drop 중 하나를 지정하여 세션을 재구성한다. Pick은 내용을 그대로 유지하고, Summarize는 AI 모델이 해당 구간을 요약하며, Drop은 히스토리에서 완전히 제외시킨다.

선택된 항목들을 바탕으로 새로운 합성 히스토리 분기가 생성되어 컨텍스트를 최적화한다. 모델은 전체 브랜치의 문맥을 참조하면서도 각 요약 블록이 독립적으로 의미를 가질 수 있도록 요약을 수행한다.

근거

구현 과정에서 읽기 전용인 SessionManager를 가변형으로 캐스팅하여 세션 데이터를 수정하는 해킹적 기법이 사용됐다. 이는 현재 pi 프레임워크의 제한 사항을 우회하기 위한 조치이며 향후 공식적인 API 지원을 목표로 하고 있다.

깃 리베이스(Git Rebase): — 기존의 커밋 히스토리를 새로운 베이스 커밋 위로 재배치하여 히스토리를 정렬하거나 통합하는 작업이다. pi-treebase는 이 개념을 LLM 세션 히스토리 관리에 도입하여 대화 기록을 편집하고 요약하는 데 활용한다.
합성 히스토리(Synthetic History): — 실제 대화 기록과 AI가 생성한 요약본을 결합하여 새롭게 구성한 대화 흐름이다. 사용자가 선택한 중요한 정보는 그대로 유지하고 덜 중요한 부분은 요약하여 컨텍스트 효율성을 높인다.
대화형 편집기(Interactive Editor): — 사용자가 텍스트 기반 인터페이스를 통해 특정 항목을 유지(Pick), 요약(Summarize), 또는 삭제(Drop)할지 결정하는 도구이다. 복잡한 세션 기록을 시각적으로 확인하며 원하는 구조로 재편성할 수 있게 돕는다.

bash

pi install npm:@grayolson/pi-treebase

pi-treebase 도구를 설치하는 명령어