Docking and pop-out windows

Kangentic runs its own window layer over the board. Task detail windows, Command Terminals, and conversation viewers are all the same kind of object: you can drag, resize, snap, tile, and maximize any of them, and several can be open at once so you can watch multiple agents side by side.

These are in-app windows, not OS windows. A separate pop-out engine moves individual panels (the Browser pane, Changes, a single file’s diff, Usage Stats, the Agent Monitor) into real OS-level windows for a second monitor; see Pop-Out Windows below.

Window states

Every window is in one of four states:

State	Meaning
Floating	Free-standing, at whatever size and position you gave it
Snapped	Occupying a half or a corner of the board area
Tiled	Sharing space with other windows in a tile group, with draggable seams between them
Maximized	Filling the area between the title bar and status bar, so window controls and live stats stay reachable

Moving and resizing

Drag a window by its header, and resize it from any edge or corner. Double-click the header to maximize or restore it.

Press Escape during a drag to abandon it: the window returns exactly where it started and nothing docks. That is also the always-available way to decline a dock you did not mean to trigger.

Docking by pointer

Docking follows one rule: wherever the cursor is decides what happens. Not the window’s edges, not its center. The cursor.

Docking to the screen

Run the cursor into an edge of the board area:

Cursor reaches	Result
Left or right edge	Snap that half
Bottom edge	Snap the bottom half
Top edge	Maximize

Screen docks arm as soon as the cursor reaches the edge, with no travel requirement. That is deliberate: a window resting near the top of the screen has almost no room left to travel, so requiring movement would make maximize physically unreachable.

Docking onto another window

Aim the cursor at an open window to tile beside it. The target splits into three bands:

The left third docks to its left and the right third docks to its right, at any height. Pointing at the left side always means dock left.
The middle third docks above or below, depending on which half of the window you are pointing at.

Unlike a screen dock, a window dock has to be earned. The pointer must travel a fair distance before it arms, so nudging a window that already sits over another one just repositions it instead of docking. The trigger for a window dock can already be true the moment you press, which is why position alone is not read as intent.

Once windows are tiled, drag the seam between them to rebalance. The Pop out control in a window’s header floats it back out of the tile group; the windows left behind stay docked and keep their widths, except that a two-window group dissolves entirely so both float.

Keyboard snapping

The snap ladder works without the pointer. Ctrl+Shift+Left / Cmd+Shift+Left and Ctrl+Shift+Right / Cmd+Shift+Right take halves, while Ctrl+Shift+Up / Cmd+Shift+Up and Ctrl+Shift+Down / Cmd+Shift+Down are stateful: Up maximizes a floating window and moves a half-snapped one to its top corner, Down restores a maximized window and moves a half-snapped one to its bottom corner. Repeat presses walk between halves and corners. Ctrl+Shift+M / Cmd+Shift+M maximizes or restores.

See Hotkeys for the full table, including the panel toggles and how to rebind any of it.

Closing a window

Close a window with Escape, Ctrl+Shift+W / Cmd+Shift+W, a middle-click on its title bar, or by clicking empty space outside it. Pausing an agent from the task detail header also closes that window.

An open menu takes Escape first. A kebab menu, a sort menu, or a view-options popover dismisses itself and stops there, so the first Escape over an open menu never closes the task window behind it. Press it again once the menu is gone to close the window.

Closing a window never stops the agent. While a window owns a session the bottom terminal panel releases it, and closing the window hands the session back.

A task window holding a loaded Browser pane for a running agent is parked rather than torn down: it disappears from the board the way any close does, but the page behind it stays loaded, so reopening the task gives you the same tab with its state intact. The park ends by itself once the agent’s session stops or the page is closed.

What persists

Window geometry is stored as a fraction of the board area rather than in pixels, so a saved layout survives a resized window, a different monitor, or a change in screen resolution.

Layouts are per project and restored on both project switch and app restart. A backgrounded project keeps its windows, which is what lets an open Browser pane stay alive while you work elsewhere. The Command Terminal is the exception: its layout persists globally, so it reopens the same way on every project.

Pop-out windows

The in-app windows above never leave the main window. For a second monitor, six surfaces can detach into a real OS window of their own through a pop-out button in their header:

Surface	Scope	Notes
Changes panel	One per task	Closing the window leaves the panel closed; click Show changes to bring it back inline
Single-file diff	One per file, up to eight at once	Opens maximized until you resize one; double-click a file row or pick Open in new window
Browser pane	One per task	Closing the window returns the pane to its split in the task window; Close browser is not offered from a pop-out
Usage Stats	One, global
Agent Monitor	One, global	Survives project switches; the title-bar icon and `Ctrl+Shift+M` / `Cmd+Shift+M` focus the window while it is open, and detail windows opened inside it move with it
Knowledge Graph	One, global	The title-bar icon and `Ctrl+Shift+A` / `Cmd+Shift+A` focus the window while it is open

Each surface remembers its size, position, maximized state, and the display it was last on, per surface rather than per task, so the Changes window for any task reopens on the monitor you keep diffs on. Opening a pop-out that already exists focuses it rather than making a second. Everything a detached surface shows stays live: the same session, diff, and monitor pushes that reach the main window are fanned out to every open pop-out.