워크스페이스·탭·페인
Agentty가 작업을 정리하는 방식 — 프로젝트마다 워크스페이스, 그 안에 탭, 탭 안에 페인.
Agentty에는 세 단계가 있습니다. 워크스페이스는 프로젝트, 탭은 그 안의 한 화면, 페인은 하나의 프로그램입니다. 페인은 셸이거나 AI 에이전트이거나 파일 편집기이거나 브라우저입니다.
워크스페이스#
사이드바(⌘B)의 행 하나하나가 워크스페이스이고, 워크스페이스마다 열리는 폴더가 하나 있습니다. ⌘N으로 만듭니다.
- 행을 드래그해 순서를 바꾸고, 하나를 다른 하나 위에 떨어뜨리면 그룹이 됩니다. 그룹은 접을 수 있고, 그룹 머리를 오른쪽 클릭하면 이름 변경, 색상, 모두 잠자기, 삭제를 할 수 있습니다.
- 목록 위 검색창은 이름, 폴더, 그 안에서 나눈 대화 내용으로 워크스페이스를 찾습니다. 검색하는 동안 목록은 결과 화면으로 바뀌고, 결과마다 어디서 일치했는지 보여 줍니다. 이름이나 폴더일 수도 있고, 검색어가 표시된 대화 한 줄과 그 말을 한 쪽(나·에이전트·도구)일 수도 있습니다. **✕**나 Esc로 검색을 지우면 전체 목록이 돌아옵니다.
- 한 세션으로 연결된 워크스페이스는 연결을 시작한 워크스페이스 아래에 모입니다. 그 워크스페이스가 접힌 그룹 안에 있으면 나머지는 원래 자리에 그대로 보입니다.
- 이름을 더블클릭해 바꿉니다.
- **⌥⌘↓ / ⌥⌘↑**로 이동하고, ⌘1…⌘9로 바로 갑니다.
- 워크스페이스와 그 탭·분할·그룹은 모두 재시작해도 그대로 돌아옵니다.
- 목록 머리의 ⚙ 를 누르면 워크스페이스 옵션이 열립니다. 카드 레이아웃(상세·간단, 상세 카드에 실행 중인 서브 에이전트를 보일지 — 최대 5개, 나머지는 "+N"으로 묶고 ⌘-클릭하면 서브 에이전트 창이 열림 — 와 에이전트의 상태·시간·토큰·금액을 보일지), 그룹화(없음·내 그룹·프로젝트별 — 저장소와 그 워크트리를 함께, 프로젝트도 그룹처럼 접힘), 정렬(수동·최근 활동·이름), 필터(잠자는 워크스페이스,
main/master브랜치, 플러그인 워크스페이스 숨기기), 탭을 제목 표시줄에 둘지를 고릅니다. 지금 보고 있는 워크스페이스는 항상 목록에 남습니다. - 워크스페이스 옵션의 정렬 아래 깨어 있는 워크스페이스 먼저를 켜면, 그룹마다 실행 중인 워크스페이스가 잠자는 워크스페이스보다 위로 올라오고 각자의 순서는 그대로입니다. 끄면 원래 순서로 돌아갑니다. 검색창 오른쪽 끝의 달 아이콘(검색창을 끄면 목록 머리에 있음)은 잠자는 워크스페이스를 보이게 하거나 숨기며(보일 때는 별이 달린 달, 숨기면 달만 표시), 필터와 같은 설정입니다.
- 창이 둘 이상 열려 있으면(파일 → 새 윈도우, 또는 다른 계정의 창) 워크스페이스 메뉴의 다른 창으로 옮기기 › 나 그룹 메뉴의 그룹을 다른 창으로 옮기기 아래 창을 눌러 그 창으로 옮깁니다. 터미널은 계속 실행되고 에이전트는 시작한 계정 그대로 세션을 이어 갑니다. 그룹은 같은 이름으로 따라갑니다.
- 워크스페이스 옵션, 사이드바 너비, 옆 패널 너비는 메인 창에서 정한 값을 모든 창이 따릅니다. 다른 창에서 바꾸면 그 창에서만 바뀐 값이 유지되고, 그 창 워크스페이스 옵션 맨 아래 메인 창 설정 따르기로 되돌립니다.
macOS에서는 탭이 창 버튼 옆 제목 표시줄에 있고, 그 옆에 사이드바 버튼(⌘B)이 있습니다. 제목 표시줄의 빈 곳을 두 번 누르면 창이 확대됩니다. 탭 줄을 따로 두려면 워크스페이스 옵션에서 탭을 제목 표시줄에 두기를 끕니다.
워크스페이스 행에 그 안의 에이전트 상태가 나오므로 열어 보지 않아도 어느 프로젝트가 나를 기다리는지 알 수 있습니다. 에이전트가 실행 중이면 상세 카드의 이름 아래에 다음 줄이 붙습니다.
- 페인 헤더와 같은 말로 나타낸 상태, 에이전트가 실행된 시간, 세션이 쓴 토큰(과 금액)
- 할 일 4/9처럼 할 일 목록의 진행 상황과 지금 하는 항목. 누르면 목록 전체가 펼쳐집니다
- 실행 중인 서브 에이전트마다 지금 하는 일과 걸린 시간, 그리고 나머지와 끝난 서브 에이전트의 개수
상태 줄과 서브 에이전트는 워크스페이스 옵션에서 각각 끌 수 있습니다.
워크스페이스 메뉴#
워크스페이스를 오른쪽 클릭하거나 ⋯ 를 누르면 메뉴가 열립니다. 폴더를 다루는 항목은 그 워크스페이스에서 선택한 창의 폴더를 씁니다.
| 항목 | 하는 일 |
|---|---|
| 다음에서 열기 › | 이 컴퓨터에 있는 편집기나 IDE(VS Code, Cursor, Zed, JetBrains IDE, Xcode 등) 또는 Finder로 폴더를 엽니다 |
| 경로 복사 | 폴더 경로를 복사합니다 |
| 워크트리 이름 복사 / 브랜치 이름 복사 | 별도 워크트리면 그 이름을, 아니면 브랜치 이름을 복사합니다 |
| 고정 | 워크스페이스를 그룹 맨 위에 둡니다 |
| 읽지 않은 것으로 표시 | 열어 볼 때까지 카드에 알림 표시를 띄웁니다 |
| 새 그룹, 그룹으로 이동 ›, 그룹에서 빼기 | 워크스페이스를 그룹으로 정리합니다 |
| 다른 창으로 옮기기 › | 실행 중인 그대로 워크스페이스를 열려 있는 다른 창으로 옮깁니다 |
| 상위 워크트리 설정… | 고른 워크스페이스 아래에 들여 써서 보여 줍니다. 그룹을 옮기면 함께 옮겨집니다 |
| 원격 접속에서 숨기기 | 워크스페이스를 원격 접속에서 뺍니다. 목록에 나오지 않고 그 터미널에도 닿을 수 없습니다. 다시 고르면 되돌리며, 숨긴 동안에는 ✓ 표시가 붙습니다. 원격 접속 기능이 켜져 있을 때만 보입니다 |
| 잠자기 | 워크스페이스의 프로그램을 모두 끝내고 상태는 그대로 둡니다. 카드는 달 표시와 함께 흐리게 보이며, Agentty를 켠 뒤 아직 열지 않은 워크스페이스도 똑같이 보입니다. 다시 열면 탭을 시작하고 에이전트 세션을 이어 갑니다 |
| 작업 트리 삭제 | 워크스페이스를 닫고 그 워크트리와 브랜치를 지웁니다. 커밋하지 않은 변경과 다른 곳에 없는 커밋은 남겨 둡니다 |
| 작업공간 삭제 | 워크스페이스를 휴지통으로 옮깁니다. 터미널이 닫히고 목록에서 사라지며, 휴지통에서 되살릴 수 있습니다 |
| 휴지통 보기 | 휴지통을 엽니다 |
탭#
⌘T는 터미널, ⌥⌘C는 Claude Code, ⌥⌘X는 Codex 탭을 엽니다. + 메뉴에도 같은 항목이 있고, 고를 수 있는 모델과 컴퓨터에서 찾은 다른 에이전트 CLI도 나옵니다.
- ⇧⌘] / ⇧⌘[ 또는 ⌃Tab으로 탭을 이동하고, ⌃1…⌃9로 바로 갑니다.
- ⇧⌘W는 탭을, ⌘W는 페인을 닫습니다.
- 탭 영역의 빈 공간을 더블클릭하면 새 탭이 열립니다.
- 탭을 오른쪽 클릭해 나중에 작업하기를 고르면 탭을 따로 빼 둡니다. 그 안에서 돌던 것은 멈추고, 시작 페이지 탭 옆 TODO 버튼에 모입니다. 거기서 누르면 다시 시작하고 에이전트는 하던 대화를 이어 갑니다.
새 탭은 워크스페이스의 폴더에서 시작합니다. 설정 → 일반에서 매번 폴더를 묻도록 바꿀 수 있습니다.
페인#
⌘D는 오른쪽으로, ⇧⌘D는 아래로 분할합니다. **⌘] / ⌘[**로 페인을 이동하고, 경계를 끌어 크기를 조절합니다.
에이전트 페인에는 상태 바가 있습니다. 모델, 컨텍스트 창, 사용 한도, 브랜치, 폴더, 그 페인에서 돌고 있는 로컬 서버 포트가 나옵니다. 위치(터미널 위 또는 아래)와 표시 항목은 설정 → 모양에서 정합니다.
이 바(상태 표시 부분이나 끌 때 잡는 아이콘)를 더블클릭하면 그 페인이 탭 전체를 차지합니다. 다시 더블클릭하면 원래 분할로 돌아갑니다.
페인 헤더에는 폴더 이름만 표시되고, 전체 경로는 상태 바에 있습니다.
사이드 패널#
터미널 옆에 붙는 패널은 모두 가장자리를 끌어 크기를 조절할 수 있습니다.
| 패널 | 단축키 |
|---|---|
| 파일과 워크트리 | ⌥⌘B |
| 인앱 브라우저 | ⇧⌘B |
| Docker | 상태 바의 🐳 |
| 플러그인 패널 | 탭 영역의 버튼 |
미니 모드#
⌃⌘M은 창을 화면 가장자리의 작은 상시 표시 패널로 접습니다. 작업을 마친 에이전트가 말풍선으로 떠오르고, 클릭하면 전체 창이 돌아옵니다.
macOS에서는 에이전트가 일하는 동안 메뉴 바 아이콘이 움직이고, 아이콘에서 에이전트 목록을 볼 수 있습니다. 창을 닫아도 메뉴 바 아이콘 덕분에 Agentty는 계속 실행됩니다.
메뉴 바 팝오버의 미니 모드 버튼 옆에는 컴퓨터의 CPU와 RAM 사용률도 나옵니다. 팝오버가 열려 있는 동안 2초마다 갱신되고, 85% 이상이면 주황색으로 바뀝니다.