#Gruppi di workspace

I gruppi di workspace ti permettono di annidare i workspace in sezioni nominate e comprimibili nella barra laterale. Ogni gruppo ha un workspace di ancoraggio implicito, un pulsante + personalizzabile per generare nuovi workspace al suo interno, e azioni del clic destro per rinominare, fissare, separare e modificare la sua configurazione.

#Concetti

#Workspace di ancoraggio

Ogni gruppo è di proprietà di esattamente un workspace chiamato ancoraggio. L'intestazione del gruppo nella barra laterale è la rappresentazione dell'ancoraggio — non c'è una riga separata per esso. Cliccando sull'area del nome dell'intestazione si mettono a fuoco i pannelli dell'ancoraggio; cliccando sul chevron si alterna la compressione.

Gli ancoraggi sono sempre completamente nuovi quando viene creato un gruppo. Non vengono mai promossi da un workspace esistente. La directory di lavoro dell'ancoraggio viene ereditata dal primo workspace selezionato quando si raggruppa una selezione, oppure dal workspace attivo quando si crea tramite il CLI senza --cwd.

Chiudere il workspace di ancoraggio dissolve il gruppo: ogni altro membro diventa un workspace non raggruppato e rimane nell'elenco dei tab. Non viene chiuso nulla oltre all'ancoraggio stesso. L'app mostra una finestra di conferma con un interruttore "Non chiedere più" prima che ciò avvenga.

#Identità del gruppo

Un gruppo ha un nome, un'icona (un SF Symbol, predefinito folder.fill) e un colore personalizzato opzionale. Questi sono indipendenti dalle personalizzazioni proprie del workspace di ancoraggio. Il colore e l'icona dell'ancoraggio vengono inizializzati dal gruppo alla creazione, ma possono divergere in seguito.

#Fissaggio

I gruppi possono essere fissati indipendentemente dai fissaggi dei singoli workspace. Le righe di primo livello fissate, siano esse singoli workspace o gruppi, restano sopra le righe non fissate. All'interno di ciascun livello, i gruppi e i workspace mantengono l'ordine in cui li trascini.

La barra laterale dispone le righe di primo livello dall'alto verso il basso:

Righe di primo livello fissate (workspace e gruppi).
Righe di primo livello non fissate (workspace e gruppi).

#Creare un gruppo

Un gruppo si crea in uno di due modi: con una scorciatoia da tastiera o dal menu contestuale di un workspace. Entrambi inseriscono un nuovo workspace di ancoraggio sopra la selezione e spostano i workspace selezionati nel gruppo. Una volta creato il gruppo, lo gestisci e vi aggiungi workspace dall’intestazione del gruppo (vedi Gestire un gruppo più avanti).

#Dalla tastiera (⌘⇧G)

Seleziona due o più workspace nella barra laterale, poi premi ⌘⇧G. Un nuovo workspace di ancoraggio viene inserito sopra la selezione e tutti i workspace selezionati diventano figli. Il gruppo viene nominato automaticamente Group 1, Group 2, e così via — rinominalo in qualsiasi momento tramite il menu contestuale dell'intestazione.

⌘⇧G entra in conflitto con la combinazione predefinita di React Grab. Il gestore del gruppo consuma la combinazione solo quando c'è una multi-selezione esplicita di almeno due workspace nella barra laterale, quindi React Grab si attiva comunque in selezione singola e nei contesti del browser o del terminale. Riassegnalo in Impostazioni → Tastiera se preferisci che i due non condividano un tasto.

I gruppi a scheda singola non vengono creati dalla scorciatoia. A tale scopo, usa la voce Nuovo gruppo da quest’area di lavoro nel menu contestuale dell'area di lavoro.

Fai clic con il tasto destro su qualsiasi area di lavoro nella barra laterale e scegli Nuovo gruppo da quest’area di lavoro, oppure Nuovo gruppo dalla selezione quando sono selezionate più aree di lavoro. Questo usa lo stesso comportamento di denominazione automatica della scorciatoia.

#Gestire un gruppo

Una volta creato il gruppo, il menu contestuale della sua intestazione e il pulsante + sull’intestazione ti permettono di gestire il gruppo e aggiungervi workspace. Nessuno dei due crea un nuovo gruppo.

#Dal menu contestuale dell'intestazione del gruppo

Fai clic con il tasto destro sull'intestazione di un gruppo esistente per accedere a Rinomina gruppo…, Fissa gruppo / Sblocca gruppo, Modifica configurazione gruppo… (che apre ~/.config/cmux/cmux.json), Apri documentazione dei gruppi, Dividi gruppo (mantieni aree di lavoro) ed Elimina gruppo (chiudi aree di lavoro). L'eliminazione è distruttiva e richiede conferma; la divisione mantiene le aree di lavoro e rimuove soltanto il contenitore.

#Dal pulsante + sull'intestazione di un gruppo

Passa il puntatore sull'intestazione di un gruppo per rivelare un pulsante + alla fine. Fai clic su di esso per creare una nuova area di lavoro nel gruppo nella directory di lavoro di ancoraggio. Fai clic con il tasto destro su di esso per accedere a Nuova area di lavoro nel gruppo, Modifica configurazione gruppo… e Apri documentazione dei gruppi.

Premendo ⌘N mentre il workspace attivo è un ancoraggio o un membro di un gruppo si crea anch'esso il nuovo workspace all'interno di quel gruppo. Il posizionamento predefinito è After current: da un normale membro del gruppo il nuovo workspace finisce subito dopo il membro attivo, e dall'ancoraggio o dall'intestazione finisce in cima al gruppo.

#CLI

Tutte le operazioni sui gruppi sono automatizzabili tramite i sottocomandi cmux workspace-group. La forma con il trattino viene rilasciata per prima; una volta disponibile il più ampio spazio dei nomi dei comandi cmux workspace, cmux workspace group diventerà la forma canonica, mentre la forma con il trattino sarà mantenuta come alias per sempre.

#Sottocomandi

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 restituisce un handle del gruppo (workspace_group:N per impostazione predefinita). Passa --json per il payload strutturato completo.

Passa a set-color o set-icon un valore vuoto per cancellare il colore o l'icona del gruppo. delete è irreversibile: chiude ogni area di lavoro membro.

#Esempi

Raggruppa i workspace attualmente selezionati sotto un nome:

cmux workspace-group create --name manaflow

Avvia un nuovo workspace all'interno di un gruppo esistente, per esempio collegato a uno script di worktree:

cmux workspace-group new-workspace workspace_group:1

Elenca i gruppi nella finestra a fuoco:

cmux workspace-group list

#Configurazione

La configurazione per gruppo si trova sotto la chiave workspaceGroups in ~/.config/cmux/cmux.json, indicizzata in base alla directory di lavoro del workspace di ancoraggio. Consulta il riferimento di configurazione per le chiavi supportate, inclusi il posizionamento globale dei nuovi workspace e il colore, l'icona, il posizionamento e le azioni del menu contestuale per directory.

riferimento di configurazione di workspaceGroups

#Persistenza

Il nome del gruppo, l'ancoraggio, lo stato di fissaggio, lo stato di compressione, il colore e l'icona vengono salvati insieme ai tuoi workspace e ripristinati tra gli avvii. L'appartenenza a un gruppo è memorizzata su ciascun workspace.