#워크스페이스 그룹

워크스페이스 그룹을 사용하면 워크스페이스를 사이드바에서 접을 수 있는 이름 있는 섹션으로 중첩할 수 있습니다. 각 그룹에는 암시적인 앵커 워크스페이스, 그룹 내부에 새 워크스페이스를 생성하는 사용자 정의 가능한 + 버튼, 그리고 이름 변경·고정·그룹 해제·설정 편집을 위한 마우스 오른쪽 버튼 작업이 있습니다.

#개념

#앵커 워크스페이스

모든 그룹은 앵커라고 하는 정확히 하나의 워크스페이스가 소유합니다. 사이드바의 그룹 헤더가 앵커를 나타내며, 앵커를 위한 별도의 행은 없습니다. 헤더의 이름 영역을 클릭하면 앵커의 패널에 포커스가 가고, 셰브론을 클릭하면 접기가 전환됩니다.

앵커는 그룹이 생성될 때 항상 완전히 새로 만들어집니다. 기존 워크스페이스가 앵커로 승격되는 일은 없습니다. 앵커의 작업 디렉터리는 선택 항목을 그룹화할 때는 첫 번째로 선택된 워크스페이스에서, --cwd 없이 CLI로 생성할 때는 활성 워크스페이스에서 상속됩니다.

앵커 워크스페이스를 닫으면 그룹이 해체됩니다. 다른 모든 멤버는 그룹화되지 않은 워크스페이스가 되어 탭 목록에 남습니다. 앵커 자체 외에는 아무것도 닫히지 않습니다. 이 동작이 발생하기 전에 앱은 "다시 묻지 않음" 토글이 있는 확인 대화 상자를 표시합니다.

#그룹 정체성

그룹에는 이름, 아이콘(SF Symbol, 기본값 folder.fill), 선택적 사용자 정의 색상이 있습니다. 이들은 앵커 워크스페이스 자체의 사용자 정의와 독립적입니다. 앵커의 색상과 아이콘은 생성 시 그룹에서 시드되지만, 이후에는 서로 달라질 수 있습니다.

#고정

그룹은 개별 워크스페이스 고정과 독립적으로 고정할 수 있습니다. 고정된 최상위 행은 개별 워크스페이스든 그룹이든 고정되지 않은 행보다 위에 유지됩니다. 각 계층 내에서 그룹과 워크스페이스는 드래그한 순서를 유지합니다.

사이드바는 최상위 행을 위에서 아래로 배치합니다:

1. 고정된 최상위 행(워크스페이스 및 그룹).
2. 고정되지 않은 최상위 행(워크스페이스 및 그룹).

#그룹 만들기

그룹은 두 가지 방법으로 만들 수 있습니다. 키보드 단축키 또는 워크스페이스 컨텍스트 메뉴입니다. 두 방법 모두 선택 항목 위에 새 앵커 워크스페이스를 삽입하고 선택한 워크스페이스를 그룹으로 이동합니다. 그룹이 생성되면 그룹 헤더에서 그룹을 관리하고 워크스페이스를 추가할 수 있습니다(아래의 그룹 관리 참조).

#키보드로 (⌘⇧G)

사이드바에서 두 개 이상의 워크스페이스를 선택한 다음 ⌘⇧G을 누릅니다. 선택 항목 위에 새 앵커 워크스페이스가 삽입되고 선택된 모든 워크스페이스가 하위 항목이 됩니다. 그룹은 자동으로 Group 1, Group 2 등으로 이름이 지정되며, 헤더 컨텍스트 메뉴를 통해 언제든지 이름을 바꿀 수 있습니다.

단일 탭 그룹은 단축키로 만들어지지 않습니다. 그런 경우에는 작업 공간 컨텍스트 메뉴의 이 작업 공간으로 새 그룹 항목을 사용하세요.

#워크스페이스 컨텍스트 메뉴에서

사이드바에서 작업 공간을 마우스 오른쪽 버튼으로 클릭하고 이 작업 공간으로 새 그룹을 선택하거나, 여러 작업 공간이 선택된 경우 선택 항목으로 새 그룹을 선택하세요. 이는 단축키와 동일한 자동 이름 지정 동작을 사용합니다.

#그룹 관리

그룹이 생성되면 헤더의 컨텍스트 메뉴와 헤더의 + 버튼을 통해 그룹을 관리하고 워크스페이스를 추가할 수 있습니다. 둘 다 새 그룹을 만들지는 않습니다.

#그룹 헤더 컨텍스트 메뉴에서

기존 그룹 헤더를 마우스 오른쪽 버튼으로 클릭하면 그룹 이름 변경…, 그룹 고정 / 그룹 고정 해제, 그룹 설정 편집…(~/.config/cmux/cmux.json을 엽니다), 작업 공간 그룹 문서 열기, 그룹 해제(작업 공간 유지), 그룹 삭제(작업 공간 닫기)를 사용할 수 있습니다. 삭제는 파괴적이며 확인을 요청합니다. 그룹 해제는 작업 공간을 유지하고 컨테이너만 제거합니다.

#그룹 헤더의 + 버튼에서

그룹 헤더 위에 마우스를 올리면 뒤쪽에 + 버튼이 나타납니다. 이를 클릭하면 앵커 작업 디렉터리에서 그룹에 새 작업 공간을 만듭니다. 마우스 오른쪽 버튼으로 클릭하면 그룹에 새 작업 공간, 그룹 설정 편집…, 작업 공간 그룹 문서 열기를 사용할 수 있습니다.

활성 워크스페이스가 그룹 앵커 또는 멤버인 상태에서 ⌘N을 누르면 해당 그룹 내부에 새 워크스페이스가 생성됩니다. 기본 배치는 After current입니다. 일반 그룹 멤버에서는 새 워크스페이스가 활성 멤버 바로 뒤에 위치하고, 앵커나 헤더에서는 그룹 맨 위에 위치합니다.

#CLI

모든 그룹 작업은 cmux workspace-group 하위 명령으로 스크립트화할 수 있습니다. 하이픈 형식이 먼저 제공되며, 더 광범위한 cmux workspace 명령 네임스페이스가 도입되면 cmux workspace group 이 표준 형식이 되고 하이픈 형식은 영구적으로 별칭으로 유지됩니다.

#하위 명령어

cmux workspace-group list [--json]
cmux workspace-group create --name "manaflow" [--cwd ~/projects/manaflow] [--from <id>,<id>]
cmux workspace-group ungroup <group-id>
cmux workspace-group delete  <group-id>
cmux workspace-group rename <group-id> --name "new name"
cmux workspace-group collapse <group-id>
cmux workspace-group expand <group-id>
cmux workspace-group pin <group-id>
cmux workspace-group unpin <group-id>
cmux workspace-group add --group <group-id> --workspace <workspace-id>
cmux workspace-group remove --workspace <workspace-id>
cmux workspace-group set-anchor --group <group-id> --workspace <workspace-id>
cmux workspace-group new-workspace <group-id> [--placement afterCurrent|top|end]
cmux workspace-group set-color <group-id> --hex "#7A4FD8"
cmux workspace-group set-icon  <group-id> --symbol ladybug.fill
cmux workspace-group move <group-id> (--to-index <n> | --before <group-id> | --after <group-id>)
cmux workspace-group focus <group-id>

create는 그룹 핸들(기본적으로 workspace_group:N)을 반환합니다. 전체 구조화된 페이로드를 얻으려면 --json을 전달하세요.

그룹의 색상이나 아이콘을 지우려면 set-color 또는 set-icon에 빈 값을 전달하세요. delete는 되돌릴 수 없습니다. 모든 구성원 작업 공간을 닫습니다.

#예시

현재 선택된 워크스페이스를 이름으로 그룹화하기:

cmux workspace-group create --name manaflow

기존 그룹 내부에 새 워크스페이스를 만들기, 예를 들어 worktree 스크립트에 연결하기:

cmux workspace-group new-workspace workspace_group:1

포커스된 창의 그룹 나열하기:

cmux workspace-group list

#설정

그룹별 구성은 ~/.config/cmux/cmux.json 의 workspaceGroups 키 아래에 있으며, 앵커 작업 공간의 작업 디렉터리를 키로 사용합니다. 전역 새 작업 공간 배치와 디렉터리별 색상, 아이콘, 배치, 컨텍스트 메뉴 작업을 포함하여 지원되는 키에 대해서는 구성 참조를 확인하세요.

workspaceGroups 구성 참조

#지속성

그룹 이름, 앵커, 고정 상태, 접기 상태, 색상, 아이콘은 워크스페이스와 함께 저장되어 실행 간에 복원됩니다. 그룹 멤버십은 각 워크스페이스에 저장됩니다.