인터페이스 및 세션 관리

이 장에서는 VelaTerm의 조직 구조 모델을 다룹니다: 3개 패널 레이아웃, 트리 관리, 탭과 분할 패널의 동작 방식, 상태 점과 필터링, 아카이빙, 그리고 전체 검색에 대해 설명합니다. 그 외의 모든 내용은 이러한 기반 위에 구축됩니다.

1. 레이아웃

두 사이드패널 모두 접을 수 있으며(가장 오른쪽의 두 개의 제목 표시줄 버튼 사용), 드래그하여 크기를 조정할 수 있습니다.

2. 트리: 프로젝트, 그룹, 세션

프로젝트는 디스크의 디렉터리에 해당하며 하위 트리의 루트가 됩니다. 그룹은 순수한 조직 구조 노드로서 임의로 중첩될 수 있습니다. 세션은 작업 단위로, 터미널이거나 에이전트 프로세스입니다. 기본 작업 디렉터리는 프로젝트 루트이며 세션의 편집 양식에서 변경할 수 있습니다.

대부분의 작업은 컨텍스트 메뉴에서 수행됩니다:

• 만들기: 프로젝트/그룹 메뉴에는 새 Claude 세션, ‘더 많은 에이전트 세션’ 항목 아래의 다양한 에이전트 유형, 새 브라우저 페이지(데스크톱), 새 그룹이 있습니다. 새 터미널 세션은 그룹 메뉴에만 있으며, 프로젝트·그룹·세션 행에 마우스를 올리면 나타나는 ＋ 버튼에서도 고를 수 있습니다. 둘 다 트리 노드가 아니라 중앙 패널의 초안 터미널을 만듭니다. 하단에는 “시작 인자와 함께 새로 만들기…”(사용자 지정 시작 인자로 생성)와 “세션 재개…”(알려진 에이전트 세션 ID를 새 노드로 연결 — agents manual 참조)도 있습니다.
• 이동: 노드를 직접 드래그하거나 마우스 오른쪽 버튼을 클릭한 후 “이동하기…”를 선택합니다. 세션도 다른 세션 아래로 이동시켜 자식 세션으로 만들 수 있습니다.
• 이름 변경/편집: 이름 변경은 이름을 수정하며, 편집은 전체 정보 입력란(이름, 작업 디렉터리, 시작 명령, 시작 인자, 권한 켜기/끄기 등)을 엽니다. Claude 세션에 이름을 지정하지 않으면 첫 메시지의 내용을 기반으로 자동으로 이름이 지정됩니다.
• 다중 선택: 여러 세션을 ⌘/Ctrl-클릭한 후 마우스 오른쪽 버튼을 클릭하여 일괄 열기, 일괄 아카이빙, 일괄 이동, 일괄 삭제를 수행할 수 있습니다.
• 접힌 상태는 재시작 후에도 유지됩니다.

세션 컨텍스트 메뉴는 더 다양합니다(항목은 세션 유형과 상태에 따라 표시됨):

3. 탭: 의도적으로 브라우저와 유사하게 설계됨

탭의 모든 동작은 세 가지 규칙으로 설명됩니다:

1. **트리에서 세션을 클릭하면 기본적으로 **현재 탭이 재사용됩니다. 더 많은 세션을 열려면 마우스 오른쪽 버튼 → “새 탭에서 열기”를 사용하세요.
2. **다른 탭으로 전환하는 것은 **닫는 것이 아닙니다: 옮겨진 탭은 백그라운드에서 계속 실행되어 프로세스와 출력이 유지되며, 언제든지 다시 전환할 수 있습니다. 백그라운드 탭에는 제한이 있습니다(기본값 32개, 설정의 “백그라운드 제한”을 통해 조정 가능); 이 제한을 초과하면 가장 오래 비활성 상태인 탭이 자동으로 종료되며, 모든 탭이 활성 상태일 경우 확인 메시지가 표시됩니다.
3. **탭을 닫으면(⌘W 또는 ×) 실제로 **프로세스가 종료됩니다. 에이전트 세션의 경우 걱정할 필요가 없습니다: 대화 내용은 기억되어 있어 해당 노드를 다시 열면 대화가 계속 이어집니다.

⌘1–9는 탭 간 전환에 사용됩니다. 탭 바 오른쪽 끝에 있는 ＋ 버튼을 사용하면 스크래치 터미널, 새 문서, 브라우저 탭을 만들 수 있습니다.

4. 패널 분할

한 탭 내에서도 터미널을 분할할 수 있습니다: ⌘D는 오른쪽으로, ⌘⇧D는 아래로 분할하며(패널 헤더에도 분할 버튼이 있음), 분할선은 드래그할 수 있습니다. 새 패널은 현재 패널의 작업 디렉토리를 상속받습니다:

백그라운드 유지 기능은 전체 탭에 적용됩니다—탭을 오가더라도 분할된 레이아웃은 그대로 유지됩니다. ⌘W는 현재 패널을 닫으며, 마지막 패널을 닫으면 탭이 종료됩니다.

5. 스크래치 세션(초안)

⌘T를 눌러 나타나는 터미널은 초안 형태입니다: 이는 중앙 패널 탭으로만 존재하며 트리나 데이터베이스에는 접근하지 않고, 탭을 닫으면 삭제됩니다(탭에는 스크래치 표시가 있음). 빠른 명령어 테스트나 일회용 ssh 연결에 사용하면 트리가 깔끔하게 유지됩니다. 터미널은 이 형태로만 존재합니다. 초안을 트리 노드로 바꾸는 메뉴 동작은 없으므로 터미널은 일회용으로 여기고, 오래 이어지는 작업은 에이전트 세션에서 하세요. 초안의 컨텍스트 메뉴도 그만큼 짧아서 열기, 새 탭에서 열기, 이름 변경, 세션 정보, 초안 닫기뿐입니다.

6. 상태 점과 필터링

각 에이전트 세션 옆의 점은 해당 세션의 실시간 상태를 나타냅니다:

상태 표시줄에는 세 가지 상태(작동 중/대기 중/확인됨)에 대한 전체 카운터가 표시됩니다; 해당 상태를 클릭하면 사이드바에 해당 상태의 세션만 표시됩니다—동시에 여러 에이전트가 작동 중일 때 이를 통해 “누가 나를 기다리고 있는지” 한눈에 확인할 수 있습니다. 사이드바의 검색 상자는 트리 노드를 이름으로 필터링합니다.

7. 아카이빙: 삭제하지 말고 보관하기

완료된 작업은 삭제할 필요가 없습니다. 세션을 마우스 오른쪽 버튼으로 클릭한 후 “세션 아카이빙”을 선택하면 해당 세션을 숨길 수 있습니다—하위 노드들을 포함한 전체 서브트리가 트리에서 제거되고 프로세스도 종료되지만, 모든 데이터는 그대로 보관됩니다. 사이드바 헤더의 아카이빙 버튼을 클릭하면 아카이빙된 세션 패널이 열립니다:

• 아카이빙된 각 세션의 내용은 **확인할 수 **있습니다: 에이전트 세션의 경우 파싱된 대화 내용(사용자/어시스턴트 메시지, 검색 및 복사 가능)이 표시되며, 대화 내용이 없는 경우에는 터미널 녹화본의 읽기 전용 재생이 제공됩니다.
• 복원을 클릭하면 세션이 트리 내의 원래 위치로 정확히 복원됩니다—에이전트 세션 ID도 그대로 유지되므로 다시 열면 원래 대화가 계속 이어집니다. 실제로 동일한 세션이 다시 생성되는 셈입니다.
• Export는 도구 호출 및 결과를 포함한 전체 대화 내용을 Markdown 파일에 저장합니다.
• Delete forever는 실제로 데이터를 영구적으로 삭제하는 유일한 방법입니다.
• 그룹은 일괄적으로 아카이브될 수 있습니다(마우스 오른쪽 버튼 → “Archive Group”): 그룹 내의 모든 세션은 아카이브 패널로 이동하며, 그 중 하나를 복원하면 해당 그룹이 다시 생성됩니다.

패널 상단의 검색 상자는 아카이브된 콘텐츠 내에서만 전체 텍스트 검색을 수행합니다.

8. 전체 검색 (⌘⇧F)

모든 세션의 이력 콘텐츠 전체에 걸쳐 검색 — 이름뿐만 아니라 에이전트의 트랜스크립트와 터미널 출력도 포함됩니다:

• 여러 키워드(순서 무관), CJK 부분 문자, 밀리초 단위 응답 시간, 관련성 순위 지정.
• 결과는 왼쪽에 세션별로 그룹화되며, 오른쪽의 미리보기에서는 현재 검색 결과가 강조 표시됩니다; ↑↓ / Enter 키를 사용해 세션 간의 검색 결과를 순차적으로 확인할 수 있습니다.
• “open session” 버튼을 클릭하면 작업 공간 내 해당 세션으로 바로 이동합니다.
• 기본적으로는 실시간 세션만 검색되며, “Include archived” 체크박스를 선택하면 검색 범위가 확장됩니다.

세션 녹화가 활성화된 경우에만 터미널 출력을 검색할 수 있습니다(설정 ▸ 고급 ▸ 세션 로그 녹화, 기본적으로 꺼짐); 에이전트의 트랜스크립트는 항상 검색 가능합니다.

9. 삭제에 대한 안전 장치

세션을 삭제하면 실제로 데이터가 삭제됩니다(그 세션의 녹화 파일도 함께 삭제됨). 하지만 여전히 아카이브된 세션이 포함된 그룹이나 프로젝트를 삭제해도 아카이브된 데이터는 사라지지 않고 아카이브 패널에 그대로 남아 있으며, 그 중 하나를 복원하면 해당 그룹이 다시 생성됩니다. 다시 말해, 걱정된다면 먼저 아카이브하는 것이 좋습니다. 아카이브된 콘텐츠는 언제든지 다시 가져올 수 있습니다.