Skip to main content

Terminals & Panels

The panel model in Daintree: the seven built-in panel kinds, the grid, dock and dialog presentations, tabs, maximize, and how panels get their titles.

Updated
Reviewed

Everything in the main content area of a Daintree window is a panel. A panel has a kind (what it is) and a location (where it currently lives). Those two axes are independent, and understanding them is most of what you need to know to move around the habitat.

This page covers the panel model itself. Terminal behavior (the renderer, scrollback, search, links, drag-and-drop, the per-terminal Scratchpad) lives on Terminals.

Panels tile the grid and share the same header controls

Panel Kinds

Daintree ships seven built-in panel kinds. Each carries its own icon and accent color, so you can tell them apart at a glance in the grid, the dock, and the quick switcher.

KindAccentProcessWhat it is
TerminalGrayPTYA shell session. Runs any command, including an agent CLI.
BrowserBlueNoAn embedded Chromium browser. See Browser Panels.
Dev PreviewTealDev serverA dev server paired with a live preview. The panel starts and owns its server, and trashing the panel stops it. See Dev Preview.
ReviewVioletNoThe Review Hub bound to one worktree, so a diff sits next to the agent producing it.
File ViewerAmberNoOne file, read as source, rendered, a diff or media. See File Viewer.
File BrowserCyanNoA tree plus folder listing for a worktree, scratch workspace, or plain project folder. See File Browser.
Diff ViewerGreenNoA single file's changes. Always opened against a target file, so it has no bare launcher entry.

Plugins register additional kinds through the same registry. Plugin panels appear through the same launcher and restoration model, labeled Plugin or Project plugin in the launcher and palette, and subject to the plugin’s contributions, trust and availability in the current project. A plugin panel can add its own buttons to the panel header and its own items to the panel's more-actions and right-click menus. Project plugins can add project-specific dashboards, inspectors and operating tools beside terminals.

Note
"Agent" is not a panel kind. An agent is a terminal panel running an agent CLI, which is why an agent panel can be searched, redrawn, restarted, and dropped on like any other terminal. See Agents for the roster and what Daintree tracks about a running agent.

Grid, Dock and Dialog

A panel you keep lives in the grid or the dock. A dialog is a third, temporary presentation for reading something without giving up a grid cell. Moving a panel between the grid and the dock never restarts it or loses its state; only its location changes.

PresentationWhat it is
GridThe main content area. This is where work happens.
DockThe compact chip row along the bottom. A docked panel stays fully live and opens in a popover on demand. Moving a panel to the dock animates it into the chip it becomes, and back again (skipped when reduced motion is on). See UI Layout.
DialogA modal over the workspace. The Review Hub, the Diff Viewer, the File Viewer and the File Browser open this way from some entry points, such as clicking a file path in a terminal. A dialog is ephemeral: it never counts toward the panel limit and is never restored on restart.

A dialog carries an Open as panel button in its header. Press it and the panel moves into the grid, keeping everything it had loaded: scroll position, expanded folders, the file you were on. That is the intended path from "glance at this" to "keep this open". It is refused when you are already at the panel limit.

Opening a new dialog normally replaces the one on screen. The exception is the Review Hub: open it as a dialog and drill into a per-file diff, and the diff layers on top with the hub still mounted underneath, so closing the diff returns you to the hub exactly as you left it. Only the topmost frame takes focus, and only the topmost frame offers Open as panel. The File Browser and Diff Viewer pin their dialogs at a fixed near-full height, so expanding a folder or stepping to the next file doesn't resize the frame under your cursor.

Open a panel as a dialog, then promote it into the grid

Two more places hold panels you have set aside. Send to background (in a panel's right-click menu) takes it out of the grid without closing it; see UI Layout for where backgrounded panels are listed. Closing a panel sends it to the trash for 20 seconds, where it keeps running and Shift-Command-T Control-Shift-T Control-Shift-T can bring it back. See Session Management.

Which kinds can be docked

Every panel kind is dockable by default; a kind opts out only when it has no meaningful compact form.

DockableNot dockable
Terminal, Browser, Dev Preview, File Viewer, File BrowserReview, Diff Viewer

The two that opt out are surfaces whose whole value is the area they occupy: a changed-file list beside its diff, and a side-by-side diff. Squeezing them into a chip row would produce something you'd have to reopen to use. They can still be presented as dialogs. Their header keeps an empty slot where the dock button would be, so the window controls line up with the panels above and below.

When a reading panel leaves the grid (docked or closed), focus returns to whatever you were last looking at rather than jumping to the first terminal in the worktree.

Creating Panels

  • The launcher is the searchable menu for starting agents, terminals, panel kinds and recipes, with entries to create a recipe, set up or manage agents, and customize the toolbar. Open it from its toolbar button or the + at the start of the dock; from the dock's +, a dockable kind opens straight into the dock. See Palettes & Menus.
  • Panel palette: Command-N Control-N Control-N opens New Panel, a picker with three sections: AI Agents, Resume Sessions (your five most recent closed agent sessions) and Tools (Browser, Dev preview, Review, File viewer, File browser and plugin kinds).
  • Direct shortcuts for the kinds you open constantly, listed below.
ActionShortcut
New terminal Option-Command-T Control-Alt-T Control-Alt-Shift-T
Terminal in the current worktree Option-Command-N Control-Alt-N Control-Alt-N
Claude Code agent Option-Command-C Control-Alt-C Control-Alt-C
Codex agent Option-Command-X Control-Alt-X Control-Alt-X
Gemini agent Option-Command-G Control-Alt-G Control-Alt-G
Browser panel Option-Command-B Control-Alt-B Control-Alt-B
File Browser panel Option-Command-F Control-Alt-F Control-Alt-Shift-F
Duplicate the focused panel Command-T Control-T Control-T
Panel palette Command-N Control-N Control-N

Terminals, browsers, dev previews and file browsers each launch through one action, so the toolbar, the launcher, the palette, a worktree card, and an agent calling it over MCP all resolve the target the same way. That is why opening a File Browser for a folder that already has one on the same surface focuses the existing panel instead of stacking a second copy.

Managing Panels

ActionShortcut
Close focused panel Command-W Control-W, or Control-F4 Control-W
Reopen last closed panel Shift-Command-T Control-Shift-T Control-Shift-T
Resume a closed session Command-K, then Command-R Control-K, then Control-R Control-K, then Control-R
Close all panels Command-K, then Command-W Control-K, then Control-W Control-K, then Control-W
Restart all panels Command-K, then Command-A Control-K, then Control-A Control-K, then Control-A
Kill the focused panel Command-K, then Command-Q Control-K, then Control-Q Control-K, then Control-Q
Restart the focused panel Command-K, then Command-E Control-K, then Control-E Control-K, then Control-E
Rename the focused panel Command-K, then Command-L Control-K, then Control-L Control-K, then Control-L
Find in the focused panel Command-F Control-F Control-F
Focus panel 1–9 Command-1, through Command-9 Control-1, through Control-9 Control-1, through Control-9
Next panel (includes docked) Control-Tab Control-Tab Control-Tab
Previous panel (includes docked) Control-Shift-Tab Control-Shift-Tab Control-Shift-Tab
Back to the previously focused panel Option-Command-` Control-Alt-` Control-Alt-`
Move the focused panel to the dock Option-Shift-Command-D Control-Alt-Shift-D Control-Alt-Shift-D
Move the focused panel to the grid Option-Shift-Command-G Control-Alt-Shift-G Control-Alt-Shift-G
Toggle every panel's dock state Option-Shift-Command-M Control-Alt-Shift-M Control-Alt-Shift-M

Three more chords act on every panel in the active worktree at once: Command-K, then Command-M Control-K, then Control-M Control-K, then Control-M docks them all, Command-K, then Command-X Control-K, then Control-X Control-K, then Control-X moves every docked one back into the grid, and Command-K, then Command-V Control-K, then Control-V Control-K, then Control-V redraws all of its terminals. The full list is on Keyboard Shortcuts.

Opening or closing a panel doesn't disturb its neighbors. The surviving panels resize straight away and keep their state: a playing video, a scroll position, the file a File Browser had open.

Moving a panel to another worktree

A panel's more-actions menu (the … in its header) has Move to worktree…, a searchable picker of the project's worktrees. The terminal right-click menu has the same thing as a Move to worktree submenu, capped at ten worktrees with More worktrees… opening the picker past that. Agent panels also offer Move to new worktree…. You can also drag a panel onto a worktree in the sidebar.

Maximize & Focus Mode

There are two ways to give your work more room, and they are easy to confuse. Maximize expands one panel to fill the grid. Focus Mode hides the worktree sidebar and the Daintree Assistant so the grid gets the window's full width; every panel stays where it is. Use maximize when you want one panel large; use Focus Mode when you want the grid without the chrome beside it.

Maximize a panel

  • Keyboard: Control-Shift-F Control-Shift-F Control-Shift-F toggles maximize on the focused panel.
  • Hotkey twice: Command-1, through Command-9 Control-1, through Control-9 Control-1, through Control-9 focuses the panel at that position. Press the same hotkey again and it maximizes; once more and the grid comes back. Pressing a different panel's number while one is maximized brings the grid back and focuses that panel.
  • Double-click the panel header: click the header's drag area: the icon or the empty space beside the title, not the title text, a tab, a button, or an input.

Double-clicking a panel's title text or a tab starts an inline rename instead, and double-clicking a docked panel's header moves it back to the grid rather than maximizing it.

A maximized panel's header carries a Restore button (tooltip Restore grid view) as the way back. If other panels are open behind it, an indicator in the center of the header counts them (N Background), and says how many are working or waiting.

Note
Maximize state is scoped per worktree. Switch away and Daintree stashes the maximize you had up; switch back and it restores it, provided the panel it named still exists. That means an oversized agent in one worktree doesn't follow you into the next one, and you don't have to re-maximize every time you come back.

Focus Mode

Focus Mode hides the worktree sidebar (rather than collapsing it) and the Daintree Assistant. The grid, the toolbar and the dock stay.

  • Keyboard: Command-K, then Command-F Control-K, then Control-F Control-K, then Control-F (a two-key chord)
  • View menu: Toggle Focus Mode
  • Command palette: Shift-Command-P Control-Shift-P Control-Shift-P , then search for "Toggle focus mode"

Use the same toggle to leave it. Focus Mode is saved per project, so reopening a project restores whichever mode you were last in, including the sidebar width you had.

Panel Tabs

A panel can hold more than one session. Once it does, the header switches from a single title to a tab bar, with each tab showing the panel's icon, a truncated title, and a close button. Single-tab panels keep the standard header and reveal a + button on hover.

Creating tabs

The + button adds a new session of the same kind as a tab beside the current one. It is offered for Terminal, Browser, Dev Preview and Review panels, and hides when the header is too narrow to hold it. Command-T Control-T Control-T is different: it duplicates the focused panel as a separate panel placed right after it, not as a tab. Agent tabs show a state badge next to the title (a green spinner arc for working, a hollow amber ring for waiting, a blue circle for directing), so you can track progress across tabs without switching.

ActionShortcut
Next tab Shift-Command-] Control-Shift-] Control-Shift-]
Previous tab Shift-Command-[ Control-Shift-[ Control-Shift-[

These work from anywhere in the panel and wrap at the edges. When the tab bar itself has keyboard focus, ArrowLeft and ArrowRight move focus between tabs, Home and End jump to the first or last, and Enter or Space switches to the focused tab. F2 renames the focused tab and Delete closes it. Arrow navigation is there for accessibility, not as the fast path.

Overflow and management

When tabs exceed the header width, the ones that don't fit move behind a chevron at the end of the tab bar, labeled Show N hidden tabs. If a hidden tab's agent is waiting, the chevron carries an amber dot and its label adds how many are waiting, so a hidden tab can't hide an agent that needs you. Switching to a tab by any means brings it into view.

  • Rename: double-click a tab title, or press F2 on a focused tab, to edit it inline. Enter or a click away confirms, Escape cancels.
  • Reorder: drag a tab left or right within the bar.
  • Close: the active tab always shows its × button; other tabs reveal theirs on hover or keyboard focus. Closing the active tab moves focus to the nearest neighbor.
  • Menu: right-click a tab for that tab's own menu, not the active tab's.
Warning
A single tab you close goes to the trash like any other panel, and Shift-Command-T Control-Shift-T Control-Shift-T brings it back within the 20-second trash window, but as a standalone panel rather than back into its tab group. Closing a whole multi-tab panel from the header restores it with all its tabs. For an agent session, Command-K, then Command-R Control-K, then Control-R Control-K, then Control-R can resume it from the session journal after the trash window has passed. See Session Management.
Each tab keeps its own title and state

Panel Grid Layout

Pick a layout strategy in Settings > Panel grid > Layout, under Grid layout:

StrategyBehavior
Automatic (default)Columns are chosen from the available width, not the panel count.
Fixed columnsLock to a Number of columns (1–10).
Fixed rowsLock to a Number of rows (1–10).

The automatic grid is size-driven. It fits as many columns as will hold a panel at least 60 terminal character columns wide (50 at compact density), measured from the live terminal font, capped at four, with a dead band at each boundary so nudging a window edge doesn't flap the whole layout. Two panels get two columns whenever they fit. Rows stretch to fill the height until a row would fall below a minimum readable height (sixteen text rows), and at that point the grid scrolls rather than shrinking panels into uselessness. Panel count on its own never triggers scroll mode; running out of vertical room does.

In scroll mode the grid uses its own overlay scrollbar rather than the platform one: a chunky, always-visible handle with a minimum size, modelled on the terminal's own slider. It re-measures whenever the layout could have changed the content height (a panel opening or closing, a column-count flip, entering or leaving scroll mode), because those change the scrollable height without firing a scroll or resize event, which is exactly when a native scrollbar goes stale.

Two-pane split

When exactly two panels are open in the grid and neither is maximized, Daintree puts a resizable divider between them instead of two equal columns. Drag it to set the ratio; each worktree remembers its own. The controls are in Settings > Panel grid > Layout, under Two-pane split:

  • Split two panels with a divider: on by default.
  • Preview-focused layout: gives more space to browser and dev-preview panels, starting the split at 65/35 in their favor. It changes the ratio, not where the panels sit.
  • Default ratio: anywhere from 20/80 to 80/20, used by a worktree that has no ratio of its own (50/50 by default).
  • Worktree split ratios: clears every per-worktree ratio so all worktrees use the default.

Moving panels and focus

  • Move focus left, right, up, or down: Option-Command-Left Arrow Control-Alt-Left Arrow Control-Shift-Left Arrow , Option-Command-Right Arrow Control-Alt-Right Arrow Control-Shift-Right Arrow , Option-Command-Up Arrow Control-Alt-Up Arrow Control-Shift-Up Arrow , Option-Command-Down Arrow Control-Alt-Down Arrow Control-Shift-Down Arrow .
  • Move the panel itself within the grid: Option-Shift-Command-Left Arrow Control-Alt-Shift-Left Arrow Control-Alt-Shift-Left Arrow , Option-Shift-Command-Right Arrow Control-Alt-Shift-Right Arrow Control-Alt-Shift-Right Arrow , Option-Shift-Command-Up Arrow Control-Alt-Shift-Up Arrow Control-Alt-Shift-Up Arrow , Option-Shift-Command-Down Arrow Control-Alt-Shift-Down Arrow Control-Alt-Shift-Down Arrow .
  • Option-Command-Z Control-Alt-Z Control-Alt-Z undoes the last layout change; Option-Shift-Command-Z Control-Alt-Shift-Z Control-Alt-Shift-Z redoes it.

To move a panel to a different worktree, see Moving a panel to another worktree.

Restore order

Reopening a project doesn't bring every panel back at once. The panel that was last on screen comes back first, then the rest of the active worktree's panels. Within every other worktree, the panel you most recently focused is restored ahead of the rest, and the remainder fill in behind on a staggered schedule. Daintree tracks this by stamping each panel with the time you last focused it. Terminal scrollback replays run a few at a time, focused panels before visible ones and visible ones before hidden ones; focusing a panel that is still waiting moves it to the front. See Session Management for what is saved and what is rebuilt.

The Empty Grid

An empty grid is a launcher, not a blank slate. Under the project's name, branch and path it stacks these sections, each arriving a beat after the one above it:

  1. Quick actions: a wide Search agents & panels… button that opens the panel palette, and below it a row of chips, one per agent whose toolbar button is currently visible, plus New terminal and Browse files, each with its shortcut. The search button comes first so its position never shifts however many agents you pin; the chip row is one tab stop, with the arrow keys moving between chips.
  2. Resume: a one-line shortcut back into a closed agent session.
  3. Recipes: run a saved workspace setup straight from here. See Recipes.
  4. Project pulse: the worktree's recent activity. See Project Pulse.
  5. Tips: a rotating hint, shown once you've launched an agent at least once.
  6. Take the Daintree Tour: an invitation to the narrated walkthrough, with Start tour and Not now. If you stopped partway, it reads Pick up the Daintree Tour with Resume tour. It disappears once you dismiss it; the tour stays in Help > Daintree Tour.

The launch controls sit directly under the project's identity because starting something is what an empty grid is for. Switching projects replays the entry sequence rather than remounting the sections, so the fetches and rotation timers behind them keep their state.

Start a session or choose a recipe from the empty grid

Panel Titles

A panel's title comes from one of three owners, and the stronger owner always wins. This is what stops an agent's own task title from overwriting a name you chose. An agent panel's header leads with the task (the agent's icon already names the agent), and its tooltip carries the full title.

OwnerSet byBehavior
DefaultNobody, the starting stateDerived from live runtime identity. Flips as detection promotes or demotes an agent, and composes in the agent's observed task title.
CustomAutomation: a preset, a launch name, an MCP or Assistant renameFrozen against detection rewrites. Task composition still applies, and a later automation rename can replace it.
UserYou, by renaming the panelFully frozen. No detection rewrite, no task composition, and automation renames bounce off it.

A user-set title survives a respawn and a restart: it is part of the panel record, not a label on the process. A duplicate keeps the text but drops to Custom, since you named the original, not the copy, and Command-T Control-T Control-T adds (copy) to any title that isn't the default. Renaming a panel to an empty string resets it to Default and hands the title back to detection. Rename with Command-K, then Command-L Control-K, then Control-L Control-K, then Control-L , by double-clicking the title text, from the panel's right-click menu, or with Rename in its more-actions menu.

Where to Go Next

  • Terminals: the renderer, scrollback, search, links, the Scratchpad, drag-and-drop, and everything else terminal-specific.
  • File Viewer: reading a single file without leaving the habitat.
  • File Browser: browsing a worktree's files and handing them to an agent.
  • QuickRun: firing off a command or a detected script from the sidebar.
  • UI Layout: the toolbar, sidebar, and dock that surround the grid.
  • Recipes: saving a panel arrangement you want back.
  • Session Management: what persists across a close, a restart, and a project switch.