Layout, sidebars, and PiP

The interface restores its tabs, splits, sidebars, and floating windows with the workspace. Arrange each workspace around its task instead of rebuilding the layout whenever you return.

For colors, fonts, and scale, see Themes and appearance.

Left sidebar

The left sidebar organizes workspaces, projects, worktrees, and feature navigation. Use the top-left control to show or hide it, and drag its inside edge to resize it.

Choose a style under Settings → Appearance:

• Compact emphasizes feature destinations. Hover a project or worktree card to see its branch, change counts, PR/MR context, and current Git action.
• Detailed keeps projects, branch rows, change counts, and status visible at a glance.

The visible-worktree limit keeps large projects manageable. Sidebar commit status can also show local commit and push state before pull-request state takes over.

Workspace theme colors change with the selected context; sidebar visibility and width remain stable so switching workspaces does not rearrange the whole window.

Feature labels and branch names

Compact rows favor a short feature label while preserving the real Git branch in the hover details. A normal task can receive an automatic label from its first prompt; a worktree created from a PR or MR can use the review title. A manual label takes precedence over both.

Rename the feature label from the worktree menu when you want clearer sidebar copy without changing Git. This is separate from Rename branch. The CLI makes the same distinction: sc worktree set-label changes only the sidebar label, while sc worktree rename-branch changes the Git branch.

Organize worktrees into sections

Sections group busy workspaces by ownership or live state. Create a section from the workspace sidebar and choose one type:

• Manual sections contain the worktrees you assign. A worktree can belong to one manual section at a time.
• Filter sections update automatically from PR/MR state, review decision, checks status, agent state, run state, or a branch glob.

A filter can match several values within one rule. Add multiple rules when the section should match more than one dimension; all rules must match. For example, a section can show branches matching feature/* whose checks are failing.

When several filter sections match the same worktree, the higher-priority filter claims it first. Priority controls matching, not where the section appears in the sidebar. Manual assignments take precedence over filters, and the built-in Pinned section always remains manual.

Right-click a worktree and choose Move to section to assign or remove it from a manual section. Edit a filter when a worktree appears in an unexpected automatic group.

Bottom chrome

The center bottom bar holds the active worktree’s adaptive Git action. The button follows local changes, branch state, and PR or MR state, so its label changes as the work moves from commit to review, merge, and cleanup.

Compact sidebar hover cards mirror the same action for other worktrees. They do not calculate a separate result. Hide or show the bottom chrome from its context menu; when hidden, move the pointer to the bottom edge to reveal it temporarily.

Right panel

The right panel holds task-level controls and supporting state, including:

• Changed files, Git status, checks, and review context.
• Setup and named run targets, process status, and output.
• Other worktree-specific supporting tools.

Show, hide, or resize the right panel independently. Run status and Git status remain attached to the worktree when the panel is collapsed.

Default sidebar shortcuts are:

Shortcut	Action
⌘E	Toggle the right panel
⌘⇧E	Toggle the left sidebar
⌘⌃E	Toggle both sidebars

Tabs

Tabs belong to their worktree and can contain chats, terminals, files, diffs, browsers, and other tools. Tab titles show current activity status when a task is working or needs attention.

Settings can change workspace-tab placement and pinned-tab style. Pin the tabs you want to keep while closing short-lived files or sessions.

Split panes and split views

Use split panes for surfaces within one view, such as a chat beside a terminal. Use a full split view when you want a larger independent column or row. The app restores the split tree and ratios.

Default keyboard actions include:

Shortcut	Layout change
⌘D	Split the current pane to the right
⌘⇧D	Split the current pane downward
⌘⌥D	Create a full view split to the right
⌘⌥⇧D	Create a full view split downward
⌘⌥W	Close the current split view

Keyboard shortcuts are configurable.

Arrange splits by dragging

Drag a tab toward a pane edge to preview and create a split. Drop it in the center to move it into that view without splitting. The outside drop ring creates a full-height or full-width view split.

You can also:

• Move tabs between existing split views.
• Drag a pane header and place that pane as a tab elsewhere.
• Drop into an empty view.
• Double-click a divider to return its adjacent splits to an even ratio.

The preview outline shows the destination before you release the pointer.

Empty views and recent tools

Closing the last tab leaves a useful empty view instead of a dead end. Launch a configured default agent, another provider, a terminal, or a browser directly from its tool cards. The Recent section reopens recent work for this context.

This launcher also makes split construction easier: create an empty split, then choose the tool that belongs there or drag an existing tab into it.

Auto-hide sidebars

Automatic sidebar hiding reclaims space until the pointer reaches the relevant edge or you use a sidebar control. Disable it under Settings → Appearance for a fixed layout.

Auto-hide changes visibility, not the underlying selection or width. Opening a queue item, command-palette result, or Git action can still reveal the surface it needs.

Pin the app window

Pin window keeps the full app above normal windows and available across macOS Spaces. Use the window-controls menu to pin or unpin it.

Pinning is useful while comparing a browser, design tool, or external editor with the active worktree. It affects window position, not Git state or session execution.

Picture in Picture

PiP opens a compact floating companion for the active session, run command, or review context. Pin the PiP window to keep it across focus changes; leave it unpinned for a temporary companion.

Press ⌘⇧P to move the active compatible tab into PiP or restore it.

PiP captures the source workspace and tab context when it opens. If it shows an older task after you switch workspaces, close it and open a new PiP from the intended tab. Pinning the full app window and pinning PiP are separate choices.