> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 사이드바: 세션, 프로젝트, 상태

> 사이드바 그룹, 세션 상태 표시, 드래그로 세션 분류, 세션과 프로젝트 메뉴, 보관, 검색, 접기를 설명합니다.

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

## 지원 범위

| 플랫폼 | 지원 여부 | 참고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 오른쪽 클릭 메뉴, 드래그, 호버 정보 카드를 지원합니다 |
| 웹 앱 | 지원 | 오른쪽 클릭 메뉴가 없으므로 **…** 버튼을 사용합니다. **Local projects** 에 폴더를 추가할 수 없습니다 |
| 모바일 웹 | 일부 지원 | 사이드바는 왼쪽 서랍입니다. 세션이나 프로젝트를 길게 누르면 액션 시트가 열립니다. 드래그와 정보 카드는 지원되지 않습니다 |

## 사이드바 구성

위에서 아래 순서는 다음과 같습니다.

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** 진입점이 표시됩니다. [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)를 참고하세요.
* **Local projects** 에는 내 모든 컴퓨터의 로컬 프로젝트가 표시됩니다. 웹 앱에서는 보기와 세션 시작만 가능하며, 세션은 프로젝트가 있는 컴퓨터에서 실행됩니다.
* Plus가 없으면 **Import from GitHub** 에 **Needs server** 표시가 붙으며, 클릭하면 먼저 Plus 구독 대화상자가 열립니다. [Plus 요금제](https://docs.aihubmix.com/ko/cloud/plus/plus-plan.md)를 참고하세요.

### 프로젝트 행

* 폴더 아이콘을 클릭하면 프로젝트의 세션을 펼치거나 접고, 프로젝트 이름을 클릭하면 프로젝트 상세 페이지가 열립니다. 세션이 많으면 나머지는 **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를 구독하면 메시지가 자동으로 전송되고 이 행은 일반 세션이 됩니다.

## 세션 상태

### 세션 행 끝의 상태

세션 행의 오른쪽 끝에는 한 번에 하나의 상태만 표시되며, 우선순위는 다음 순서(높은 순)입니다.

| 상태 | 표시 내용 | 의미 | 사라지는 시점 |
| - | - | - | - |
| 입력 필요 | 텍스트 라벨 **Needs input** | 작업 승인이나 질문에 대한 답변을 기다리고 있거나, 세션이 사용자를 위해 일시 중지됨 | 처리한 뒤 |
| 진행 중 | 회전하는 로더 | AI가 작업 중 | 세션이 완료되거나, 중지되거나, 입력이 필요해질 때 |
| 완료, 읽지 않음 | 테마 색의 채워진 점 | 세션이 완료되었고 아직 열어 보지 않음 | 세션을 연 뒤 |

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

### 읽음으로 표시

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

## 드래그

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

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

프로젝트 행을 누른 채 대상 위치로 드래그하고 놓으면 순서 변경이 완료됩니다.

* 같은 섹션 안에서만 순서를 바꿀 수 있습니다.
* 고정한 프로젝트는 항상 고정하지 않은 프로젝트 위에 있으며, 서로 위치를 바꿀 수 없습니다.
* 단일 목록 보기에서는 프로젝트를 드래그할 수 없습니다.

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

세션을 프로젝트 위로 드래그해 놓으면 해당 프로젝트로 분류되고, **Recents** 위로 드래그하면 프로젝트 밖으로 이동합니다. 접힌 그룹이나 프로젝트 위에서 잠시 머무르면 자동으로 펼쳐집니다. 프로젝트 안에서 세션 순서를 바꿀 수는 없습니다.

| 출발 → 도착 | 결과 | 실행 중인 세션 이동 가능 여부 |
| - | - | - |
| 프로젝트 A → 같은 섹션의 프로젝트 B | 사이드바 그룹만 바뀌며, A의 작업 디렉터리와 브랜치에서 작업이 계속됩니다. 세션에 메모가 추가되며 **Undo** 할 수 있습니다 | 가능 |
| 프로젝트 안 → **Recents** | 그룹만 바뀌며 **Undo** 할 수 있습니다 | 가능 |
| **Recents** 의 세션 → 임의의 프로젝트 | 먼저 **Move to B? New messages will run in this project; files in the old scratch folder won't be brought over.** 를 확인합니다. 이 작업은 **되돌릴 수 없습니다** | 불가. **Stop or finish the task before moving it to a project** 메시지가 표시됩니다 |
| 프로젝트 안 → 다른 섹션의 프로젝트 | 놓을 수 없습니다 | 해당 없음 |

기타 제한:

* 하위 세션은 상위 세션과 함께 이동하며 따로 드래그할 수 없습니다.
* 프로젝트가 아직 설정 중이거나 다른 컴퓨터에 있는 경우 세션을 안으로 또는 밖으로 이동할 수 없습니다. 이유를 알려 주는 메시지가 표시됩니다.
* 세션 행을 대화 영역으로 드래그해 분할 보기를 열 수도 있습니다. [분할 보기](https://docs.aihubmix.com/ko/cloud/interface/split-view.md)를 참고하세요.

**프로젝트 간 이동이 그룹만 바꾸는 이유**: 각 프로젝트는 저장소와 실행 환경에 대응하며, 세션은 이미 원래 프로젝트의 브랜치에서 코드를 변경했습니다. 그룹만 바꾸면 세션 자체에 영향을 주지 않고 사이드바를 자유롭게 정리할 수 있습니다.

### 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** (**…**)도 같은 메뉴입니다. 각 항목의 단축키는 [키보드 단축키](https://docs.aihubmix.com/ko/cloud/interface/keyboard-shortcuts.md)를 참고하세요.

| 메뉴 항목 | 참고 |
| - | - |
| Rename | 1–80자의 제목 |
| Pin / Unpin | 마우스를 올린 행의 고정 버튼과 같습니다 |
| Mark as read / Mark as unread | |
| New side chat | 세션 페이지 상단 바의 메뉴에만 있습니다. [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md#side-chat)을 참고하세요 |
| Fork › | **Fork chat in same worktree** (완료된 응답이 하나 이상 필요), **New chat in this worktree** (프로젝트, 에이전트, 모델, 권한을 유지한 빈 세션) |
| Copy › | **Copy link**, **Copy as Markdown**, **Copy working directory** (프로젝트에 속한 세션) |
| Move to project… | 위를 참고하세요 |
| Open in new tab | 웹 앱에서 새 브라우저 탭으로 엽니다 |
| Export as .cshare | 세션 공유 파일을 내보냅니다 |
| Session timer | 세션 페이지 상단 바의 메뉴에만 있습니다 |
| Archive | 아래의 "보관"을 참고하세요 |
| Delete permanently | 세션이 실행 중이거나 승인을 기다리는 동안에는 사용할 수 없습니다. 삭제하기 전에 확인하며, 채팅 기록은 복구할 수 없고 프로젝트 파일은 영향을 받지 않습니다 |

웹 앱에서는 `⌘` (Windows: `Ctrl`)를 누른 채 세션 행을 클릭하면 새 탭에서 열립니다. `⌥` (Windows: `Alt`)를 누른 채 클릭하면 분할 보기에 추가됩니다.

## 프로젝트 … 메뉴

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

| 메뉴 항목 | 참고 |
| - | - |
| Pin / Unpin | 고정한 프로젝트는 해당 섹션의 맨 위에 있습니다 |
| Edit | 프로젝트 설정 페이지를 엽니다 |
| Open on GitHub | 프로젝트에 GitHub 저장소가 있을 때 표시됩니다 |
| Reveal in Finder | 데스크톱 앱에서 이 컴퓨터의 로컬 프로젝트에 표시됩니다. Windows에서는 파일 탐색기를 사용합니다 |
| Archive chats | 이 프로젝트의 모든 세션을 한 번에 보관합니다 |
| Delete project… | 클라우드 환경과 그 파일을 삭제하며, 되돌릴 수 없습니다. 프로젝트의 세션은 보관됩니다. 푸시되지 않은 변경 사항이 있으면 프로젝트 이름을 입력해 확인해야 합니다. [프로젝트 › 프로젝트 삭제](https://docs.aihubmix.com/ko/cloud/projects/projects.md#delete-project)를 참고하세요 |

## 정보 카드

데스크톱 앱과 데스크톱 브라우저에서 세션 행이나 프로젝트 행에 마우스를 잠시 올려 두면 정보 카드가 표시됩니다.

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

## 보관

**보관** 은 세션을 사이드바에서 제거하지만 기록은 유지하며, 나중에 복원할 수 있습니다.

* 진입점: 세션 **…** 메뉴의 **Archive**, 단축키 `⇧⌘A` (Windows: `Ctrl+Shift+A`), 프로젝트 **…** 메뉴의 **Archive chats** (프로젝트 전체).
* 보관한 뒤 토스트에서 **Undo** 를 클릭할 수 있습니다.
* 보관된 세션은 **Settings › Archived chats** 에서 보고, 복원하고, 영구 삭제할 수 있습니다. [보관된 채팅](https://docs.aihubmix.com/ko/cloud/settings/archived.md)을 참고하세요.

## 채팅 검색

사이드바 상단의 돋보기를 클릭하거나 `⌘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은 무슨 뜻인가요?

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

## 관련 문서

* [인터페이스 개요](https://docs.aihubmix.com/ko/cloud/interface/overview.md)
* [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md)
* [분할 보기](https://docs.aihubmix.com/ko/cloud/interface/split-view.md)
* [키보드 단축키](https://docs.aihubmix.com/ko/cloud/interface/keyboard-shortcuts.md)
* [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)
* [보관된 채팅](https://docs.aihubmix.com/ko/cloud/settings/archived.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.