Agentty/문서

워크스페이스·탭·페인

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% 이상이면 주황색으로 바뀝니다.