snowpea desktop — 사용자 안내서

Agent (agent.snowpea.ai) · Registry (registry.snowpea.ai)

snowpea desktop은 실행 중인 snowpea core를 들여다보는 데스크톱 창입니다. 실제 작업은 모두 core가 맡습니다. 세션과 메모리, 예약된 작업, 자격 증명은 전부 core가 소유합니다. IDE는 core와 통신하는 세 가지 클라이언트 중 하나이며, 나머지 둘은 snowpea 터미널 UI와 헤드리스 CLI입니다.

이는 생각보다 중요한 사실입니다. 같은 SNOWPEA_HOME을 공유하는 클라이언트는 모두 하나의 데몬을 공유하고, 따라서 하나의 세션 집합을 공유합니다. 여기서 시작한 스레드는 TUI에서도 보이고, 오늘 아침 터미널에서 시작한 세션은 앱을 열면 사이드바에 그대로 있습니다.

화면 구성

화면	라우트	용도
스레드	/	에이전트와의 대화: 스트리밍 답변, 승인, 슬래시 명령
diff 리뷰	/thread/:id/diff	에이전트가 변경한 내용을 파일 단위로 승인하거나 거부
에이전트	/agents	에이전트 정의, 실행 중인 서브에이전트, 이름 있는 에이전트와 채널
워크트리	/worktrees	병렬 팀 실행: 작업 보드와 그 뒤의 워크트리
터미널	/terminal	앱 안에서 프로젝트마다 하나씩 동작하는 실제 셸
파일	/files	프로젝트의 읽기 전용 파일 트리와 뷰어
스킬	/skills	마켓플레이스에서 스킬을 검색하고 설치
스케줄	/schedule	반복 작업과 일회성 작업, 그리고 실시간 이벤트 피드
게이트웨이	/gateway	채팅 플랫폼 바인딩과 무인 승인 대기열
메모리	/memory	에이전트의 장기 기억을 기록하고 검색
설정	/settings	프로바이더, 프로젝트 기본값, 셸 허용 목록, 외형
설정 마법사	/setup	최초 실행 구성. 이후에도 설정 화면에서 언제든 열 수 있음

화면이 아닌 주제를 다루는 문서가 더 있습니다. 스레드 화면 안에서 쓰는 첨부 파일과 음성, 스레드의 작업 디렉터리를 고르는 사이드바인 프로젝트, Files와 diff 리뷰, 채팅이 함께 쓰는 파일 뷰어인 뷰어, 설정에서 시작하는 프로바이더 로그인과 업데이트, 앱의 겉모습을 다루는 테마, 그리고 빌드와 배포를 다루는 패키징입니다.

공통 UI

세 가지는 항상 화면에 떠 있습니다.

• 왼쪽 레일에는 위의 화면들이 나열됩니다. Ctrl/⌘ 1 … 9로 n번째 항목으로 이동하고, Ctrl/⌘ B로 레일을 아이콘만 남기고 접을 수 있습니다.
• 하단 상태 표시줄은 core의 상태를 알려줍니다. connected 여부, 양쪽이 합의한 프로토콜 버전, 적용 중인 테마, 그리고 열려 있는 모든 스레드의 토큰 합계입니다. 언어 서버가 돌고 있으면 lsp 2 칸이 함께 나오고, 깨진 서버가 있으면 경고색으로 남아 있습니다. 자세한 내용은 설정 → 도구에 있습니다. connected가 아니라면 이 문서의 다른 기능은 아무것도 동작하지 않으며, 그 이유는 설정 문서에서 설명합니다.
• 명령 팔레트는 어디서든 Ctrl/⌘ K로 열거나, 빈 입력창에 /를 입력하면 열립니다. core의 슬래시 명령을 실행하므로, 제공되는 명령은 설치된 스킬에 따라 달라집니다.

키보드

?를 누르면 전체 목록이 나옵니다. 앱이 실제로 사용하는 것과 같은 표에서 생성되므로 내용이 어긋날 일이 없습니다.

키	동작
Ctrl/⌘ K	명령 팔레트 열기
?	단축키 목록 보기
Esc	맨 위에 있는 오버레이나 대화 상자 닫기
Ctrl/⌘ B	사이드바 접기 또는 펼치기
Ctrl/⌘ ,	설정 열기
Ctrl/⌘ 1 … 9	n번째 화면으로 이동
Ctrl/⌘ Enter	프롬프트 전송
Ctrl/⌘ V	붙여넣기 — 클립보드 이미지는 첨부, 아니면 텍스트 붙여넣기
Ctrl/⌘ .	실행 중인 턴 중단
a / r	diff 리뷰에서 포커스된 파일 승인 / 거부

core를 찾지 못할 때

core가 설치되지 않은 컴퓨터에서도 앱은 spawn 오류로 죽지 않습니다. 대신 사용 중인 플랫폼의 설치 명령과 Retry(다시 시도) 버튼, Choose binary…(바이너리 선택) 선택기가 있는 화면을 보여줍니다. core를 설치하고 Retry를 누르면 앱은 하던 곳에서 이어집니다. 패키징된 빌드에서 core가 어디서 오는지는 패키징을 참고하세요.