← Reference
Session groups
Free-form visual clusters of session tiles in Mission Control (GPU) — a user-made grouping with arbitrary meaning (corral the less-important sessions, cluster a project's sessions, …), NOT derived from the code project.
Full notes from the app
A group reads as its tiles sitting together under a soft themed wash with a small editable label, and stays contiguous through grid reflow. Membership, label, and colour persist per workspace (restored on reattach). Built by drag-to-gather; managed from the context menu. Start-simple v1: tiles stay individually visible (no collapse), colour is auto-assigned from a curated themed palette and re-tints with the theme.
6 entries · kcode 0.4.0
6 shown
| Action | How |
|---|---|
| Create / add | Drag one session tile ONTO another to cluster them (mints a new group holding both, auto-labelled 'Group' with the next free swatch colour). Drag a further tile onto any member to add it to that group. The swatch colours are resolved from the active theme (2026-07-26): the ring is the design system's actor-colour rotation over the theme's own accent and status hues, with near-duplicate and near-grey candidates dropped, so switching theme re-tints every existing cluster and a high-contrast or light theme gets group colours that suit it. It was previously a fixed set of eight pastels painted identically on every theme. |
| Create / add (keyboard) | Context menu → Group with… on a session tile, or the ⌘P palette's 'Group with…' for the focused session: a type-to-filter list of the other open tiles, each showing the group it is already in. Choosing one gathers this session into that tile's cluster — minting a group holding both when the target is ungrouped — exactly as dragging onto it would, and a session already in the same cluster is not listed. Exists so building a group never requires a pointer. |
| Remove | Drag a grouped tile out of its cluster (into a gap away from its groupmates) to drop it from the group. Emptying a group forgets it. |
| Focus | Context menu → Focus group on any member: maximizes just that cluster — its tiles fill the window side-by-side and every other tile is hidden (the single-tile Maximize widened to the group). Escape returns to the grid. |
| Rename | Context menu → Rename group on any member: a text-editor overlay pre-filled with the current label; the new name persists and shows in the cluster's pill. |
| Ungroup | Context menu → Ungroup on any member: dissolves the whole cluster — every member leaves and the group is forgotten. |