`/tree` 명령어 레퍼런스

/tree는 대화형 세션 트리 탐색기를 엽니다. 현재 세션 파일의 모든 항목으로 이동하여 해당 지점부터 계속할 수 있습니다.

이것은 파일 내 리프 이동이며, 새로운 세션 내보내기가 아닙니다.

`/tree`의 기능

현재 세션 항목에서 트리를 구축합니다 (SessionManager.getTree())
키보드 탐색, 필터, 검색 기능이 포함된 TreeSelectorComponent를 엽니다
선택 시 AgentSession.navigateTree(targetId, { summarize, customInstructions })를 호출합니다
새로운 리프 경로에서 보이는 채팅을 재구축합니다
user/custom 메시지를 선택할 때 선택적으로 에디터 텍스트를 미리 채웁니다

주요 구현:

src/modes/controllers/input-controller.ts (/tree, 키바인딩 연결, 이중 Escape 동작)
src/modes/controllers/selector-controller.ts (트리 UI 실행 + 요약 프롬프트 흐름)
src/modes/components/tree-selector.ts (탐색, 필터, 검색, 레이블, 렌더링)
src/session/agent-session.ts (navigateTree 리프 전환 + 선택적 요약)
src/session/session-manager.ts (getTree, branch, branchWithSummary, resetLeaf, 레이블 영속성)

여는 방법

다음 중 하나로 동일한 선택기를 열 수 있습니다:

/tree
설정된 키바인딩 액션 tree
빈 에디터에서 이중 Escape (doubleEscapeAction = "tree"인 경우, 기본값)
/branch (doubleEscapeAction = "tree"인 경우, 사용자 전용 분기 선택기 대신 트리 선택기로 라우팅)

트리 UI 모델

트리는 세션 항목의 부모 포인터(id / parentId)에서 렌더링됩니다.

자식은 타임스탬프 오름차순으로 정렬됩니다 (오래된 것이 먼저, 새로운 것이 아래)
활성 분기(루트에서 현재 리프까지의 경로)는 불릿으로 표시됩니다
레이블(있는 경우)은 노드 텍스트 앞에 [label]로 렌더링됩니다
여러 루트가 존재하는 경우(고아/끊어진 부모 체인), 가상 분기 루트 아래에 표시됩니다

트리 뷰 예시 (활성 경로는 •로 표시):

├─ user: "작업 시작"
│  └─ assistant: "계획"
│     ├─ • user: "접근법 A 시도"
│     │  └─ • assistant: "A 결과"
│     │     └─ • [milestone] user: "A 계속"
│     └─ user: "접근법 B 시도"
│        └─ assistant: "B 결과"

선택기는 현재 선택 항목을 중심으로 재배치되며 최대 다음만큼의 행을 표시합니다:

max(5, floor(terminalHeight / 2)) 행

트리 선택기 내 키바인딩

Up / Down: 선택 이동 (순환)
Left / Right: 페이지 위 / 페이지 아래
Enter: 노드 선택
Esc: 검색이 활성화된 경우 검색 지우기; 그렇지 않으면 선택기 닫기
Ctrl+C: 선택기 닫기
Type: 검색 쿼리에 추가
Backspace: 검색 문자 삭제
Shift+L: 선택된 항목의 레이블 편집/지우기
Ctrl+O: 필터를 앞으로 순환
Shift+Ctrl+O: 필터를 뒤로 순환
Alt+D/T/U/L/A: 특정 필터 모드로 직접 이동

필터 및 검색 의미론

필터 모드 (TreeList):

default
no-tools
user-only
labeled-only
all

`default`

대부분의 대화 노드를 표시하지만 관리용 항목 유형은 숨깁니다:

label
custom
model_change
thinking_level_change

`no-tools`

default와 동일하며, 추가로 toolResult 메시지를 숨깁니다.

`user-only`

역할이 user인 message 항목만 표시합니다.

`labeled-only`

현재 레이블로 확인되는 항목만 표시합니다.

`all`

관리용/custom 항목을 포함하여 세션 트리의 모든 것을 표시합니다.

도구 전용 어시스턴트 노드 동작

도구 호출만 포함하고 텍스트가 없는 어시스턴트 메시지는 다음의 경우를 제외하고 모든 필터 뷰에서 기본적으로 숨겨집니다:

메시지가 오류/중단됨 (stopReason이 stop/toolUse가 아닌 경우), 또는
현재 리프인 경우 (항상 표시 유지)

검색 동작

쿼리는 공백으로 토큰화됩니다
매칭은 대소문자를 구분하지 않습니다
모든 토큰이 일치해야 합니다 (AND 의미론)
검색 가능한 텍스트에는 레이블, 역할, 유형별 콘텐츠(메시지 텍스트, 분기 요약 텍스트, custom 유형, 도구 명령어 스니펫 등)가 포함됩니다

선택 결과 (중요)

navigateTree는 선택된 항목 유형에 따라 새로운 리프 동작을 계산합니다:

`user` 메시지 선택

새로운 리프는 선택된 항목의 parentId가 됩니다
부모가 null인 경우(루트 사용자 메시지), 리프는 루트로 재설정됩니다 (resetLeaf())
선택된 메시지 텍스트가 편집/재제출을 위해 에디터에 복사됩니다

`custom_message` 선택

사용자 메시지와 동일한 리프 규칙 (parentId)
텍스트 콘텐츠가 추출되어 에디터에 복사됩니다

비사용자 노드 선택 (assistant/tool/summary/compaction/custom 관리용 등)

새로운 리프는 선택된 노드 id가 됩니다
에디터에 미리 채워지지 않습니다

현재 리프 선택

무동작; 선택기가 “이미 이 지점에 있습니다” 메시지와 함께 닫힙니다

선택 결정 (간략화):

선택된 노드
   │
   ├─ 현재 리프인가? ── 예 ──> 선택기 닫기 (무동작)
   │
   ├─ user/custom_message인가? ── 예 ──> leaf := parentId (루트의 경우 resetLeaf)
   │                                     + 에디터 텍스트 미리 채우기
   │
   └─ 그 외 ──> leaf := 선택된 노드 id
                    + 에디터 미리 채우기 없음

전환 시 요약 흐름

요약 프롬프트는 branchSummary.enabled로 제어됩니다 (기본값: false).

활성화된 경우, 노드를 선택한 후 UI가 다음을 묻습니다:

요약 없음
요약
사용자 정의 프롬프트로 요약

흐름 세부 사항:

요약 프롬프트에서 Escape를 누르면 트리 선택기가 다시 열립니다
사용자 정의 프롬프트 취소 시 요약 선택 루프로 돌아갑니다
요약 중에 UI는 로더를 표시하고 Esc를 abortBranchSummary()에 바인딩합니다
요약이 중단되면 트리 선택기가 다시 열리고 이동이 적용되지 않습니다

navigateTree 내부 동작:

이전 리프에서 공통 조상까지 버려진 분기 항목을 수집합니다
session_before_tree를 발생시킵니다 (확장 기능이 취소하거나 요약을 삽입할 수 있음)
요청되고 필요한 경우에만 기본 요약기를 사용합니다
다음을 통해 이동을 적용합니다:
- 요약이 있는 경우 branchWithSummary(...)
- 요약 없는 비루트 이동의 경우 branch(newLeafId)
- 요약 없는 루트 이동의 경우 resetLeaf()
에이전트 대화를 재구축된 세션 컨텍스트로 교체합니다
session_tree를 발생시킵니다

참고: 사용자가 요약을 요청했지만 요약할 내용이 없는 경우, 요약 항목을 생성하지 않고 탐색이 진행됩니다.

레이블

트리 UI에서의 레이블 편집은 appendLabelChange(targetId, label)을 호출합니다.

비어 있지 않은 레이블은 확인된 레이블을 설정/업데이트합니다
빈 레이블은 이를 지웁니다
레이블은 추가 전용 label 항목으로 저장됩니다
트리 노드는 원시 레이블 항목 기록이 아닌 확인된 레이블 상태를 표시합니다

`/tree` vs 인접 작업

작업	범위	결과
`/tree`	현재 세션 파일	선택된 지점으로 리프를 이동 (동일 파일)
`/branch`	보통 현재 세션 파일 -> 새 세션 파일	기본적으로 선택된 사용자 메시지에서 새 세션 파일로 분기; `doubleEscapeAction = "tree"`인 경우, `/branch`는 대신 트리 탐색 UI를 엽니다
`/fork`	전체 현재 세션	세션을 새로운 영속 세션 파일로 복제
`/resume`	세션 목록	다른 세션 파일로 전환

핵심 구분: /tree는 하나의 세션 파일 내에서의 탐색/위치 변경 도구입니다. /branch, /fork, /resume는 모두 세션 파일 컨텍스트를 변경합니다.

운영자 워크플로우

현재 분기를 잃지 않고 이전 사용자 프롬프트에서 다시 실행

/tree
이전 사용자 메시지를 검색/선택
요약 없음 선택 (필요한 경우 요약)
에디터에 미리 채워진 텍스트 편집
제출

효과: 동일 세션 파일 내에서 선택된 지점으로부터 새 분기가 성장합니다.

컨텍스트 브레드크럼과 함께 현재 분기 떠나기

branchSummary.enabled 활성화
/tree로 대상 노드 선택
요약 선택 (또는 사용자 정의 프롬프트)

효과: 계속하기 전에 대상 위치에 branch_summary 항목이 추가됩니다.

숨겨진 관리용 항목 조사

/tree
Alt+A 누르기 (all)
model, thinking, custom 또는 레이블 검색

효과: 대화 노드뿐만 아니라 전체 내부 타임라인을 검사합니다.

나중에 이동할 피벗 포인트 북마크

/tree
항목으로 이동
Shift+L을 누르고 레이블 설정
나중에 Alt+L (labeled-only)을 사용하여 빠르게 이동

효과: 지속적인 분기 랜드마크 간 빠른 탐색이 가능합니다.