Choose a parent for a session from its menu or the command palette

The CompozyOS window manager is now as simple as a browser. Each desktop has one tab bar, a tab holds one window or several windows split side by side, and a window only opens or closes. Floating windows, minimize, zoom, snapping and tabs inside a pane are gone, and with them the windows that could get hidden, overlap or end up off-screen.

• Tab bar. Open, close, reorder, pin and reopen tabs the way you do in a browser. Tabs shrink to fit, then scroll with a list of the ones that do not fit. The bar is one keyboard stop: Left, Right, Home and End move between tabs. Right-click a tab for Pin tab, Move left / Move right, Split with ▸, Arrange ▸, Move to desktop ▸ and the close set (Close tab, Close other tabs, Close tabs to the right, Close tabs to the left, Close all tabs), which skips pinned tabs.
• Splits by drag. Drag a tab down onto a window and drop it on the side you want. Near the outer edge of the work area the drop covers the whole edge. Drag a window by its header to move it inside the tab, or hold Shift to swap two windows.
• Resize at the seams only. Drag the line between two windows, or focus it and use the arrow keys; double-click it to make both sides equal. Arrange ▸ offers Main and stack, Columns, Grid and Balance sizes.
• Move to new tab replaces maximize. A window in a split has Move to new tab in its header and in the Window menu, or you can drag its header up onto the tab bar.
• Desktops. The desktops overview lists each desktop's tabs, reorders desktops by drag, takes tabs dropped on a card and closes a desktop in place after you choose where its tabs go. The desktop dots in the top bar have a menu (Rename, Move left, Move right, Close desktop, New desktop) and accept a dragged tab. Moving a tab to another desktop leaves you on the desktop you are on. A desktop that holds only New tab placeholders counts as empty, so compozy desktop delete removes it without --destination.
• Each screen keeps its own active tab. Two browsers or app windows on one workspace each have their own active tab, so switching tabs in one never moves the other.
• Settings › Layouts edits a saved layout as desktops, their tabs and the splits inside each tab, and imports layouts saved by earlier versions.
• Agents and scripts split, unsplit and move with compozy window move and compozy__window_move (new --placement tab and --tab / target_tab_id), reorder tabs with the new compozy window reorder, close with the new scopes left and all, balance a whole tab with layout balance --tab, and get the hook events window_manager.tab.split, window_manager.tab.unsplit and window_manager.tab.activated.

Nesting a session under another used to need a drag, or a submenu that listed only the sessions already loaded in the sidebar.

• Move under…. A session's row menu and right-click menu open a parent picker that searches the project's sessions by title or agent. Arrow keys and Enter choose the new parent, and the confirmation offers Undo.
• From the command palette. With a session window focused, type move or parent and choose "Move under another session…" to open the same picker.
• Back to the top level. On a nested session, the picker offers Make top-level, as the row menu does.
• Continued and forked sessions stay put. Their picker explains that they stay linked to the session they came from instead of listing parents. The daemon's refusal now says the same.

Two windows of a split could trade places only by dragging one header onto the other with Shift held.

• Window › Swap. With a window in a split focused, Swap ▸ lists Left, Right, Up and Down for each side that has a neighbour. The focused window trades places with that neighbour and keeps focus.
• From the command palette. Type swap and choose Swap left, Swap right, Swap up or Swap down. A side with no window does nothing; swaps never wrap around.
• Your own shortcut. The four commands (window.swap.left, .right, .up, .down) ship unbound. Assign a chord in Settings › Shortcuts. Existing shortcut settings load unchanged.
• One undo step. Layout undo puts both windows back.

On macOS, an expired, malformed or unscoped .credentials.json left in Claude Code's config directory no longer reports Claude usage as signed out while Claude Code is logged in through the Keychain. With Keychain access allowed, CompozyOS reads the Keychain login through its existing silent, cached path; without consent it asks for Keychain access instead of asking you to log in again. A usable credential file still takes precedence and never triggers a Keychain read. Linux and Windows are unchanged.

Migration notes: no action needed. Existing consent settings and credential stores are preserved.

Sending a large terminal selection to a conversation no longer fills the screen. The quote in the composer has a bounded height with its own scroll, keeps the terminal's line breaks and spacing, and can be collapsed with its chevron; quotes longer than 12 lines start collapsed. The composer input and controls stay visible on desktop and phone-width windows.

Migration notes: no action needed.

Continuing a child session no longer moves the new session to the top of the session list. When an orchestrator continues a worker, for example after a daemon restart stopped it, the continuation now appears in the orchestrator's thread next to the session it continues. This also holds when a session is continued more than once. Continuations of top-level sessions and forks still show as top-level sessions, and the continued session still names its source as "Continued from".

Only placement in the list changes. Permissions, lifecycle and child counts work as before: a continuation is not counted as one of the parent's children and does not stop when the parent stops. Session list and detail reads now include tree_parent_session_id, the parent a continuation is listed under. Sessions continued before this release move under their parent the next time the list loads; no migration is needed.

When the desktop app cannot reach its update feed, it now downloads the release the daemon already selected straight from the GitHub release and verifies it against the release's signed checksum. A failed update now says which network error stopped the download, such as net::ERR_CONNECTION_CLOSED, instead of "The app update could not be installed."

Migration notes: the fix ships in the updater itself. If updating from 0.6.0, 0.6.1, or 0.6.2 keeps failing with a connection error, download this release once from the GitHub release page and install it manually; later updates use the fallback automatically.

CompozyOS reuses MCP tool discovery across open sessions with the same provider listing scope during each refresh window, reducing repeated discovery and descriptor processing. Sessions retain their own tool permissions and availability checks, and separate workspaces and profiles keep separate listings. Catalog changes retain the existing refresh bound.

Marking the "Your windows are now tabs" bell notice read now records every listed upgrade together before updating the stored layouts, so a failure no longer leaves the bell partly read; if updating a stored layout fails, the next bell read finishes it. Upgrades over several projects show one toast naming them instead of one identical toast each, and an upgrade that was already announced does not toast again after a reload.

Migration notes: no action needed.

Native tools and subagent supervision handle several edge cases more reliably. One failed native-result row no longer stops other replay work. A failed MCP discovery attempt is retried by peers instead of being shared as a complete tool list, while healthy tools stay available. Monitors on child sessions no longer depend on whether you viewed the child. Scheduler and harness heartbeat wakes use the agent's current heartbeat policy. A native approval that expires is reported as approval_timed_out with guidance to ask again, instead of looking like an explicit rejection.

Migration notes: no action needed.

Moving a window between tabs and splits keeps your place more reliably. A session transcript returns to the same text after a tab switch or a width change and no longer drifts forward once shown; a turn that started while its tab was hidden is shown when you come back. Lists such as the Files tree keep their offset after a tab drag into a split, a list beside a detail keeps its offset after a later move, and a list that an in-window navigation sends to the top right after a tab switch stays at the top. Moving a shown window into a new tab with compozy window move --placement tab keeps its pane open instead of reloading it.

Migration notes: no action needed.

Reopen closed tab (⌘⇧T) now brings back a window that was closed beside a nested split in its original slot and share: with A on the left and B over C on the right, closing and reopening A returns it as the left column beside the B/C branch instead of squeezing it next to B. When the branch's windows no longer sit together, the window returns beside its former neighbor as before.

Migration notes: no action needed. Windows closed before this release reopen with the previous single-neighbor behavior.

Registered worktrees now leave the active checkout path before a paced background worker deletes their files. Large dependency trees no longer hold the repository lock throughout file deletion. Cleanup pauses during CPU pressure, resumes leftovers on startup and falls back to synchronous removal when staging cannot rename the checkout.

The worktree removal CLI, native tool and HTTP/UDS API accept batches with per-target outcomes and a dry_run risk preview. Existing single-target request and response shapes are preserved. Failed fenced reads restore the original record, and repeating removal reconciles abandoned removing records without restarting the daemon.

Migration notes: no action needed. Background cleanup may retain staged bytes under the managed worktrees root until CPU pressure subsides.

Collection rediscovers profile-specific roots after restart and only empties CompozyOS-owned trash. Existing trash folders stay untouched, submodule checkouts retain Git's synchronous safety checks, and CLI batch timeouts scale with the number of targets.

Interrupted staging now restores verified checkout bytes before retrying safety checks. Failed restores keep the removal fence and preserve staged changes across retries and daemon recovery.

After staged safety checks succeed, CompozyOS durably records removal approval before clearing Git registration. Recovery uses that approval to finish an interrupted state write without restoring a broken checkout. External Git pruning alone never authorizes deletion of refused staged changes.

Configured worktrees roots reached through directory symlinks support staged removal, recovery and clean rollback without stranding the checkout. Literal percent signs and Unicode directory names remain unchanged when resolving those roots.

Holding an arrow key on a split seam against a slow daemon no longer keeps resizing after the key is released: the steps that wait behind a resize in flight on that seam are sent as one resize. Balance sizes for a whole tab (tab menu, Window › Arrange, command palette) now applies the same fit check as double-clicking a seam: it evens only the splits that can be evened together without showing a split one window at a time. A balance or move made by the same window during a seam drag re-bases the drag instead of cancelling it, the seam's limit state appears with the frame that reaches the clamp, and queued seam input deadlines use a monotonic clock.

Migration notes: no action needed.

CompozyOS reuses workspace and profile skill settings while their configuration files stay unchanged, reducing idle daemon CPU use with many workspaces. Configuration edits, including file creation and deletion, still take effect on the next skill watcher poll.

Migration notes: no action needed.

CompozyOS promotes queued session replies, monitor wakes, and child completion wakes into long-running turns even when the provider adds ACP defaults to the live runtime. Inputs with an explicit different runtime still wait for their own turn, and debug logs identify runtime-mismatch skips without exposing runtime values.

Migration notes: no action needed.

CompozyOS reuses each session writer's transcript encoding buffer, reducing allocation pressure while long, tool-heavy agent turns stream. Transcript contents and write durability stay unchanged, and oversized buffers are released after both successful and failed encodes.

CompozyOS now reads only triage sessions during periodic triage cleanup, reducing background CPU and metadata-cache pressure for large session histories. Deleted session metadata is evicted without waiting for a full session listing, including when a metadata read overlaps deletion. Archive and retention behavior stays unchanged.

Unsaved edits in the agent editors (Instructions, Heartbeat, Memory, the authored SOUL and HEARTBEAT files, Permissions and the Tools panel) are no longer lost when the window manager takes the editor away. Closing the window or tab with Cmd+W, a close from the menu, or a bulk close now asks first; a bulk close asks once for every affected window. Navigation started from outside the window, such as compozy window navigate or a project switch, keeps the draft in memory instead: the editor shows it as unsaved when you return, and saving it goes through the usual conflict check.

Migration notes: no action needed.

Opening or focusing a window from the dock, the palette or a menu now adds exactly one browser history entry, so one Back returns to the window you came from. Before, dock Files could overwrite the previous entry and Back stayed on Files.

When you move focus yourself (directional focus, next or previous tab, Focus last window, the dock, the palette, a menu, Back or Forward), the keyboard now moves into the window you focused: to the field you last typed in there, or to the window itself. Focus sent from the CLI or another client still moves only the focused window and leaves the keyboard where you are typing.

After a daemon restart, an open browser or desktop client comes back on the desktop it was showing, with the same window focused, if both still exist.

Migration notes: no action needed.

Several rough edges left after tabs and splits are fixed:

• Editing a shortcut at project scope now saves only what differs from the inherited settings, so later user-level changes still reach that project. Existing project files load the same values; the next project save drops copies equal to the inherited value.
• Agent and extension rows in the command palette update without a reload, and a disabled extension shows "disabled" instead of a health word.
• A terminal window that hit the per-project terminal limit opens a terminal as soon as a slot frees up. Dismissing the limit dialog shows the empty state with its open control.
• Removing a project whose window layout can't be read answers 503 window_manager_unavailable with the project and ID to retry, instead of a generic 500. Retrying compozy workspace remove finishes the removal.
• compozy hooks list shows a user-level hook once instead of once per registered project. JSON output is unchanged.
• The tab context menu groups its commands the same way as the other CompozyOS menus.

Migration notes: no action needed.