Navigation
Navigation (내비게이션)
CoCo Desktop은 Agent view와 Editor view 두 가지 레이아웃 뷰를 제공해요. 그래서 에이전트와 작업하는 데 집중하거나, 코드를 작성하는 데 집중할 수 있어요.
출처: Navigation
본문
Agent 뷰와 Editor 뷰 전환하기
에이전트가 주요 초점일 때는 Agent view를 사용해요. 왼쪽에 대화와 프로젝트, 가운데에 채팅, 오른쪽에 도구 모음이 배치돼요. 전통적인 코드 편집기를 원할 때는 Editor view를 사용해요. 가운데에 파일, 양쪽에 도구, 보조 패널에 선택적 채팅이 배치돼요.
전환하는 방법
- 창 오른쪽 위의 뷰 컨트롤 사용: 왼쪽이 Agent, 오른쪽이 Editor예요. 활성 모드가 강조 표시돼요.
- macOS에서 ⌘E, Windows와 Linux에서 Ctrl+E를 눌러요.
뷰 컨트롤은 Agent를 먼저, 그다음 Editor를 보여줘요. 두 옵션 중 하나를 클릭하거나 키보드 단축키를 사용해 레이아웃을 전환해요.
뷰를 전환할 때 CoCo는 어떤 사이드 패널이 열려 있었는지 기억해서, 되돌아왔을 때 레이아웃이 익숙하게 느껴져요. 열린 파일, 채팅 세션, Snowflake 연결은 그대로 유지돼요.
팁
뷰를 전환할 때 별도의 "저장" 단계는 없어요. Agent view에서 대화 중이었다면, Editor view로 돌아와 메인 편집기에서 파일을 편집한 뒤 다시 전환해 채팅을 이어갈 수 있어요.
Agent view
Agent view는 대화를 최우선으로 해요. 창에는 세 영역이 있어요: 왼쪽의 내비게이션 패널, 가운데의 메인 영역, 오른쪽의 도구 모음 — 채팅 옆에 보조 패널을 여는 아이콘 기둥이에요.
내비게이션 패널(왼쪽)
내비게이션 패널은 대화와 프로젝트 사이를 이동하는 곳이에요. 위쪽에 바로 가기가 있고, 그 아래에 내 폴더와 지난 세션이 담긴 Projects 목록이 있어요.
상단 바로 가기
| 바로 가기 | 역할 |
|---|---|
| New session | 새 채팅을 시작해요. 키보드: ⌘N / Ctrl+N. |
| Automations | 메인 영역에서 자동화 관리를 열어요. Automations 참고. |
프로젝트와 세션
바로 가기 아래에는 다음이 있어요.
- Projects는 내가 추가한 폴더 또는 워크스페이스예요. 프로젝트를 펼치면 그 세션(개별 채팅)이 보여요.
- 세션을 클릭하면 가운데에서 열려요.
- 내비게이션 패널 헤더의 customize 컨트롤로 트리·목록 레이아웃을 전환하고, 세션을 검색하고, 필터링할 수 있어요(예: 안 읽은 것만).
- add 컨트롤로 다른 프로젝트를 추가해요. Open Folder…로 로컬 폴더를, Connect to SSH host…로 원격 호스트를, Clone repo로 Git 저장소를 복제해 프로젝트로 열 수 있어요.
- 프로젝트나 세션을 오른쪽 클릭하면 세션 이름 바꾸기, Editor view로 프로젝트 열기, 목록에서 프로젝트 제거 같은 동작이 있어요.
도구 모음(오른쪽)
도구 모음은 창 오른쪽 가장자리의 세로 아이콘 띠예요. 아이콘을 클릭하면 채팅 옆에 패널이 열려요. 일부 도구는 바로 위에 고정되고, 다른 도구는 필요할 때 나타났다가 끝나면 닫을 수 있어요. 그 열에서는 한 번에 하나의 도구 패널만 활성화돼요.
위에서 아래로 도구 모음에는 보통 문서, 앱 내 Browser, SQL Playground, Apps, Files, 계정·협업 도구, Source Control 접근이 포함되고, Terminal과 Changes 같은 추가 패널을 위한 More 메뉴가 있어요.
| 도구 | 역할 | 적용 대상 |
|---|---|---|
| Files | 프로젝트 파일을 열고 미리 봐요. 빠른 열기: ⌘P / Ctrl+P. 파일 트리는 내비게이션 패널에, 미리 보기는 도구 패널에 나타날 수 있어요. | 현재 프로젝트 |
| Browser | 웹 미리 보기와 에이전트 주도 브라우징을 위한 앱 내 브라우저. | 현재 세션 |
| SQL Playground | Snowflake 계정에 SQL을 실행해요. | 현재 세션 |
| Apps | Editor view와 같은 Apps 갤러리. | 현재 프로젝트 |
| Terminal | 통합 터미널. ⌘J / Ctrl+J. | 현재 프로젝트 |
| Changes | 에이전트가 수정한 파일의 통합 diff를 검토해요. 변경 파일 트리와 범위 선택기가 있어요. 여기서 변경을 수락하거나 거부해요. ⌘2 / Ctrl+2. | 현재 세션 |
| Source Control | Git 상태, 스테이징, 커밋. | 현재 프로젝트 |
| Agent Settings | Editor view의 Agent Settings 활동 바 아이콘과 같은 설정. | 현재 프로젝트 |
Browser와 Changes 같은 세션 범위 도구는 활성 채팅에 묶여요. Terminal과 Source Control 같은 프로젝트 범위 도구는 내가 작업 중인 프로젝트 폴더를 따라가요.
Agent Manager 헤더
대화 위의 헤더는 이동하고 작업을 넘겨주는 두 가지 방법을 제공해요.
- Universal Navigator. Agent Manager 헤더의 Back과 Forward 버튼(각각 키보드 단축키 포함)은 Agent view의 모든 것 — 대화, 받은 편지함, 예약 작업, SnowBoard, 에이전트 명단, cron 대시보드, 사이드 패널 — 을 가로질러 이동하며, 브라우저의 기록처럼 있던 전체 뷰를 복원해요.
- "Open in" 분할 버튼. 현재 대화의 폴더를 Editor, Finder, 또는 Terminal에서 열어요. 버튼을 클릭하면 마지막 대상지를 재사용하고, 드롭다운으로 다른 곳을 고를 수 있어요. CoCo는 선호 대상을 기억해요.
Agent view 팁
- 내비게이션 패널에서 프로젝트를 펼쳐 최근 세션을 다시 열거나, New session으로 새로 시작해요.
- 에이전트가 파일을 편집한 뒤에는 커밋 전에 Changes를 열어 diff를 검토해요.
- 다중 파일 편집이나 디버깅이 많을 때는 전체 편집기 레이아웃이 필요한 Editor view로 전환해요.
- 도구 사용에 대한 승인 동작은 별도로 제어돼요. Permission modes를 참고해요.
Editor view
Editor view는 파일 편집기를 중심으로 구성돼요. 활동 바(activity bar)는 맨 왼쪽의 좁은 아이콘 기둥이에요. 아이콘을 클릭하면 옆에 해당 패널이 열리거나 초점이 맞춰져요. 그 영역에서는 한 번에 하나의 활동 바 패널만 표시돼요.
표준 활동 바 아이콘
이 아이콘들은 VS Code와 같은 방식으로 동작해요.
| 이름 | 역할 |
|---|---|
| Explorer | 열린 프로젝트의 파일과 폴더를 탐색해요. |
| Search | 워크스페이스 전체에서 텍스트를 찾아요. |
| Source Control | Git 변경 검토, 파일 스테이징, 커밋. |
| Run and Debug | 애플리케이션을 실행하고 디버깅해요. |
| Extensions | 편집기 확장을 설치하고 관리해요. |
Cortex와 Snowflake 아이콘
추가 아이콘은 CoCo를 Snowflake와 에이전트 기능에 연결해요.
| 이름 | 역할 |
|---|---|
| Snowflake Catalog | 데이터베이스, 스키마, 테이블 등 Snowflake 객체를 탐색해요. |
| Skills | 워크플로를 위한 재사용 가능한 에이전트 스킬을 탐색하고 관리해요. |
| Apps | Snowflake 앱을 만들고 미리 보고 배포하는 Apps 갤러리를 열어요. |
| Agent Settings | 에이전트 프로필, 모델, MCP 커넥터, 훅, 권한을 구성해요. |
| Automations | 반복 에이전트 프롬프트를 만들고 관리해요. Automations 참고. |
편집기 탭으로 열리는 뷰
Apps, Agent Settings, 또는 Automations를 클릭하면 좁은 사이드 패널이 아니라 창 가운데에 전체 편집기 탭이 열려요. 그래서 갤러리, 설정 양식, 자동화 목록에 더 많은 공간이 생겨요. 활동 바 아이콘을 다시 누르거나 탭을 닫으면 그 뷰에서 나와요.
Editor view의 Session 패널
내 채팅은 창 오른쪽의 Session 패널에 나타나요. 활동 바에는 없어요. 패널 헤더는 SESSION을 표시하며, 새 세션 시작, 새로고침, 패널 닫기 컨트롤이 있어요. Recent sessions에는 다시 열 수 있는 지난 대화가 나열돼요.
창 가운데는 편집기와 빠른 동작(예: 시작 화면의 New session, Launch browser, Launch notebook)을 위한 공간이에요. Session 패널은 View 메뉴나 상단 바의 레이아웃 컨트롤에서 열거나 숨겨요.
하단 패널
창 아래쪽에는 Terminal, Problems, Output, 관련 뷰를 보여줄 수 있어요. 프로젝트에 dbt가 있으면 dbt 프로젝트가 감지될 때 dbt 탭이 그곳에 나타나요.
Editor view 팁
- 사이드 패널 가장자리를 드래그해 크기를 조절해요.
- 편집기 공간이 더 필요하면 ⌘B / Ctrl+B로 사이드 바를 숨겨요.
- Snowflake Catalog로 데이터를 탐색한 뒤, Session에서 채팅을 통해 찾은 것을 에이전트에게 물어봐요.
더 알아보기
- Permission modes — 도구 사용 승인 모드
- Automations — 반복 에이전트 프롬프트