메인 콘텐츠로 건너뛰기
사이드바 는 Cloud Tasks 페이지 왼쪽에 있는 세션 목록입니다. 세션과 프로젝트를 찾고, 열고, 정리하는 데 사용합니다. 각 세션은 사이드바에 한 번만 표시됩니다. 프로젝트에 속한 세션은 해당 프로젝트 아래에, 어떤 프로젝트에도 속하지 않은 세션은 Recents 에, 고정한 세션은 Pinned 에 표시됩니다.

지원 범위

사이드바 구성

위에서 아래 순서는 다음과 같습니다.
  1. 상단: New chat 과 Search chats 돋보기.
  2. Pinned: 고정한 세션. 고정한 세션이 없으면 표시되지 않습니다.
  3. Cloud projects: GitHub에서 가져오거나, 클라우드에서 만들거나, 클라우드에 업로드한 프로젝트와 그 아래의 세션.
  4. Local projects: 내 컴퓨터의 폴더에서 만든 프로젝트와 그 아래의 세션.
  5. Recents: 어떤 프로젝트에도 속하지 않은 세션. 최근 활동순으로 정렬됩니다.
각 그룹 헤더를 클릭하면 접거나 펼칠 수 있으며, 그 상태는 앱을 다시 열어도 유지됩니다.

클라우드 프로젝트와 로컬 프로젝트

프로젝트는 현재 실행 위치와 관계없이 출처 로 분류됩니다. 내 컴퓨터의 폴더에서 만든 프로젝트는 클라우드로 옮긴 뒤에도 항상 Local projects 에 남습니다. 그 밖의 모든 프로젝트는 Cloud projects 에 있습니다.
  • 섹션 헤더에 마우스를 올리면 오른쪽에 프로젝트를 만드는 + 가 표시됩니다. 섹션이 비어 있으면 Import from GitHub 또는 Add a local folder 진입점이 표시됩니다. 프로젝트를 참고하세요.
  • Local projects 에는 내 모든 컴퓨터의 로컬 프로젝트가 표시됩니다. 웹 앱에서는 보기와 세션 시작만 가능하며, 세션은 프로젝트가 있는 컴퓨터에서 실행됩니다.
  • Plus가 없으면 Import from GitHub 에 Needs server 표시가 붙으며, 클릭하면 먼저 Plus 구독 대화상자가 열립니다. Plus 요금제를 참고하세요.

프로젝트 행

  • 폴더 아이콘을 클릭하면 프로젝트의 세션을 펼치거나 접고, 프로젝트 이름을 클릭하면 프로젝트 상세 페이지가 열립니다. 세션이 많으면 나머지는 Show more 아래에 있습니다.
  • 프로젝트 행에 마우스를 올리면 오른쪽에 고정 버튼, Project actions (…), New task in this project 가 표시됩니다. 모바일 웹에서는 New task in this project 가 항상 표시되며, 프로젝트 이름을 길게 누르면 프로젝트 메뉴가 열립니다.
  • 고정한 프로젝트는 항상 해당 섹션의 맨 위에 있습니다.

하위 세션

에이전트가 보낸 하위 세션은 상위 세션 아래에 중첩되어 표시됩니다. 상위 세션 행에는 하위 세션의 수가 표시되며, 숫자를 클릭하면 펼치거나 접을 수 있습니다. 완료된 하위 세션은 N completed 한 행으로 접힙니다. 포크나 New chat in this worktree 로 만든 세션은 하위 세션이 아닙니다.

Plus가 없을 때의 대기 세션

Plus가 없으면 보낸 메시지가 멈추고, 세션은 이 기기에만 저장됩니다. 이 세션은 사이드바에 한 행으로 표시되며, 메뉴에는 Delete (복구할 수 없음)만 있습니다. Plus를 구독하면 메시지가 자동으로 전송되고 이 행은 일반 세션이 됩니다.

세션 상태

세션 행 끝의 상태

세션 행의 오른쪽 끝에는 한 번에 하나의 상태만 표시되며, 우선순위는 다음 순서(높은 순)입니다.
  • 메시지 전송에 실패하면 세션 행에 Not sent 가 표시됩니다.
  • 그룹, 섹션, 프로젝트, Show more 가 접혀 있으면 숨겨진 세션이 헤더 오른쪽에 가장 우선순위가 높은 하나의 상태로 요약됩니다. 펼치면 각 행에 자체 상태가 표시됩니다.

읽음으로 표시

  • ⇧Esc (Windows: Shift+Esc)를 누르면 읽지 않은 세션이 모두 한 번에 읽음으로 표시됩니다.
  • 세션의 … 메뉴에 있는 Mark as read / Mark as unread 로 하나씩 표시할 수 있습니다.

드래그

데스크톱 앱과 웹 앱에서는 사이드바의 프로젝트와 세션을 바로 드래그할 수 있습니다. 드래그 중에 Esc 를 누르면 취소됩니다. 모바일 웹에서는 드래그가 지원되지 않습니다.

프로젝트 드래그: 순서 변경

프로젝트 행을 누른 채 대상 위치로 드래그하고 놓으면 순서 변경이 완료됩니다.
  • 같은 섹션 안에서만 순서를 바꿀 수 있습니다.
  • 고정한 프로젝트는 항상 고정하지 않은 프로젝트 위에 있으며, 서로 위치를 바꿀 수 없습니다.
  • 단일 목록 보기에서는 프로젝트를 드래그할 수 없습니다.

세션 드래그: 프로젝트로 분류하거나 Recents로 되돌리기

세션을 프로젝트 위로 드래그해 놓으면 해당 프로젝트로 분류되고, Recents 위로 드래그하면 프로젝트 밖으로 이동합니다. 접힌 그룹이나 프로젝트 위에서 잠시 머무르면 자동으로 펼쳐집니다. 프로젝트 안에서 세션 순서를 바꿀 수는 없습니다. 기타 제한:
  • 하위 세션은 상위 세션과 함께 이동하며 따로 드래그할 수 없습니다.
  • 프로젝트가 아직 설정 중이거나 다른 컴퓨터에 있는 경우 세션을 안으로 또는 밖으로 이동할 수 없습니다. 이유를 알려 주는 메시지가 표시됩니다.
  • 세션 행을 대화 영역으로 드래그해 분할 보기를 열 수도 있습니다. 분할 보기를 참고하세요.
프로젝트 간 이동이 그룹만 바꾸는 이유: 각 프로젝트는 저장소와 실행 환경에 대응하며, 세션은 이미 원래 프로젝트의 브랜치에서 코드를 변경했습니다. 그룹만 바꾸면 세션 자체에 영향을 주지 않고 사이드바를 자유롭게 정리할 수 있습니다.

Move to project… 메뉴

드래그가 불편하면 세션의 … 메뉴에서 Move to project… 를 선택합니다. 규칙은 드래그와 같습니다. 프로젝트를 검색할 수 있으며, 이동할 수 없는 프로젝트는 이유와 함께 회색으로 비활성화됩니다. 이미 프로젝트에 속한 세션에는 Move to Recents 항목이 추가되며, 맨 끝에 New project 가 있습니다.

사이드바 정리

Cloud projects 헤더에 마우스를 올리고 오른쪽의 … (Organize and sort) › Organize sidebar 를 클릭합니다.
  • By project (기본값): 위에서 설명한 그룹으로 표시합니다.
  • In one list: 모든 세션을 하나의 Recents 목록에 넣고, 각 행에 프로젝트를 표시합니다.
이 선택과 프로젝트의 수동 순서는 계정에 저장됩니다.

세션 … 메뉴

세션 행에 마우스를 올리고 … 를 클릭하거나, 데스크톱 앱에서 세션 행을 오른쪽 클릭하거나, 모바일 웹에서 세션 행을 길게 누르면 세션 메뉴가 열립니다. 세션 페이지 상단 바의 Chat actions (…)도 같은 메뉴입니다. 각 항목의 단축키는 키보드 단축키를 참고하세요. 웹 앱에서는 ⌘ (Windows: Ctrl)를 누른 채 세션 행을 클릭하면 새 탭에서 열립니다. ⌥ (Windows: Alt)를 누른 채 클릭하면 분할 보기에 추가됩니다.

프로젝트 … 메뉴

프로젝트 행에 마우스를 올리고 … (Project actions)를 클릭하거나, 데스크톱 앱에서 프로젝트 행을 오른쪽 클릭하거나, 모바일 웹에서 프로젝트 이름을 길게 누릅니다.

정보 카드

데스크톱 앱과 데스크톱 브라우저에서 세션 행이나 프로젝트 행에 마우스를 잠시 올려 두면 정보 카드가 표시됩니다.
  • 세션 정보 카드: 제목, 마지막 활동 이후 경과 시간, 프로젝트와 출처, 현재 상태.
  • 프로젝트 정보 카드: 프로젝트 이름, 세션 수, 출처(GitHub 저장소 또는 로컬 폴더), 클라우드 서버 상태, Edit project. 다른 컴퓨터의 로컬 프로젝트인 경우 새 작업이 실행될 컴퓨터가 표시됩니다.

보관

보관 은 세션을 사이드바에서 제거하지만 기록은 유지하며, 나중에 복원할 수 있습니다.
  • 진입점: 세션 … 메뉴의 Archive, 단축키 ⇧⌘A (Windows: Ctrl+Shift+A), 프로젝트 … 메뉴의 Archive chats (프로젝트 전체).
  • 보관한 뒤 토스트에서 Undo 를 클릭할 수 있습니다.
  • 보관된 세션은 Settings › Archived chats 에서 보고, 복원하고, 영구 삭제할 수 있습니다. 보관된 채팅을 참고하세요.

채팅 검색

사이드바 상단의 돋보기를 클릭하거나 ⌘K (Windows: Ctrl+K)를 눌러 세션 제목과 프로젝트 이름으로 검색합니다. ⏎ 를 누르면 첫 번째 결과가 열리고, Esc 를 누르면 검색이 닫힙니다.

사이드바 접기

  • 데스크톱 앱: 상단 바 왼쪽 영역의 사이드바 토글을 클릭하거나 ⌘\ / ⌘B (Windows: Ctrl+\ / Ctrl+B)를 누릅니다.
  • 웹 앱: 사이드바 왼쪽 위의 Hide sidebar 를 클릭합니다. 접히면 메인 영역 왼쪽 위에 Show sidebar 와 New chat 이 표시됩니다. 단축키는 같습니다.
  • 모바일 웹: 메인 영역 왼쪽 위의 Open menu 를 탭하거나 화면 왼쪽 가장자리에서 오른쪽으로 스와이프해 엽니다. 왼쪽으로 스와이프하거나 오버레이를 탭해 닫습니다. 서랍 하단에 Projects, Activity, Scheduled tasks, Cloud server 진입점과 계정이 있습니다.

FAQ

내 세션이 Recents에 없는 이유는 무엇인가요?

Recents 에는 어떤 프로젝트에도 속하지 않은 세션만 있습니다. 프로젝트에 속한 세션은 해당 프로젝트 아래에, 고정한 세션은 Pinned 에만 표시됩니다. ⌘K 를 눌러 검색할 수 있습니다.

세션을 다른 프로젝트로 드래그하면 새 프로젝트에서 실행되나요?

아니요. 이미 프로젝트에 속한 세션을 같은 섹션의 다른 프로젝트로 옮기면 사이드바 그룹만 바뀌며, 원래 프로젝트의 작업 디렉터리와 브랜치에서 계속 진행됩니다. Recents 의 세션을 프로젝트로 옮길 때만 이후 메시지가 해당 프로젝트에서 실행되며, 이 작업은 되돌릴 수 없습니다.

웹 앱에서 로컬 프로젝트를 볼 수 있나요?

네. 웹 앱에도 Local projects 와 그 세션이 표시되지만, 웹에서는 로컬 폴더를 추가할 수 없습니다. 로컬 프로젝트에서 만든 세션은 프로젝트가 있는 컴퓨터에서 실행됩니다.

접힌 프로젝트 옆의 Needs input은 무슨 뜻인가요?

접힌 프로젝트 안에 숨겨진 세션 중 하나 이상이 승인, 답변, 작업을 기다리고 있다는 뜻입니다. 프로젝트를 펼치면 어떤 세션인지 확인할 수 있습니다.

관련 문서