에이전트 인식

여러 에이전트를 동시에 실행하면 모든 터미널을 지켜볼 수 없습니다. 각 노드는 사용자의 도움이 필요한 시점과 자신이 작업 중인 위치를 알려야 하므로, 계속 지켜보지 않고도 바로 대응할 수 있습니다. TermTree는 터미널에서 실행 중인 에이전트 CLI를 인식하여 이를 처리합니다. 현재 Claude Code를 지원하고 Codex도 감지합니다. 물론 노드의 터미널에서 반드시 에이전트를 실행해야 하는 것은 아닙니다. 일반 셸로 사용할 수 있으며, TermTree는 에이전트가 실행 중일 때 이를 추가로 인식할 뿐입니다.

워크트리 표시기

git 워크트리에 진입한 에이전트는 자신의 작업 디렉터리를 해당 위치로 변경하며, 그때부터 출력, 스택 추적, git status에서 워크트리 루트를 기준으로 한 경로를 보고합니다. 이는 창의 셸 디렉터리를 기준으로 한 경로가 아닙니다. 에이전트가 어느 워크트리에 있는지 놓치면 잘못된 파일 사본을 검토하게 될 수 있으므로, TermTree가 이를 자동으로 표시합니다.

TermTree는 터미널의 포그라운드 에이전트가 git 워크트리 안에서 작업 중임을 감지하면 해당 노드와 터미널 제목 표시줄에 워크트리 아이콘을 표시합니다. 아이콘 위에 마우스를 올리면 워크트리의 브랜치 이름을 볼 수 있습니다.

이 표시기는 재시작 후에도 유지됩니다. TermTree를 다시 열어도 에이전트가 워크트리에 있던 노드에는 계속 표시됩니다.

네이티브 Windows에서는 사용할 수 없습니다. 워크트리 감지는 POSIX 스타일 경로 확인에 의존하므로 네이티브 Windows 셸에서는 작동하지 않습니다. 호스트가 에이전트의 작업 디렉터리를 볼 수 없게 만드는 WSL 경계를 넘어서도 사용할 수 없습니다. 이 경우 TermTree는 셸이 보고한 디렉터리를 대신 사용합니다.

Claude 세션 재개

노드를 선택한 상태에서 Cmd+Shift+R / Ctrl+Shift+R을 누르면 해당 Claude Code 세션을 재개할 수 있습니다(claude --resume). 터미널이 닫혔거나 재개 명령을 다시 입력하지 않고 대화로 돌아가고 싶을 때 유용합니다. 앱을 재시작한 후에도 이 작업이 자동으로 수행되는 방식은 세션 유지를 참조하세요.

TermTree가 에이전트가 사용자를 기다리고 있음을 파악하는 방법

INPUT 상태(주황색 점)는 에이전트가 차단되어 사용자의 응답을 기다리고 있음을 의미합니다. TermTree는 다음 두 가지 방식으로 이를 감지합니다.

Claude Code — 확정적 감지. TermTree는 ~/.claude/settings.json에 Notification 훅을 등록하고 각 터미널의 환경에 TERMTREE_NODE_ID를 삽입합니다. Claude가 알림을 보내면(예: 도구 호출 권한을 요청할 때) TermTree는 사용자의 주의가 필요한 노드를 확실하게 파악합니다. 터미널의 텍스트를 보고 추측하는 것이 아닙니다.
기타 CLI — 패턴 일치 기반 대체 방식. 훅 연동이 없는 에이전트의 경우 TermTree는 터미널 출력에서 일반적인 차단 프롬프트 패턴(예: [y/N] 형식의 확인 메시지)을 검색하여 터미널이 입력을 기다리고 있다고 추론합니다.