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.
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.
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.
| Kind | Accent | Process | What it is |
|---|---|---|---|
| Terminal | Gray | PTY | A shell session. Runs any command, including an agent CLI. |
| Browser | Blue | No | An embedded Chromium browser. See Browser Panels. |
| Dev Preview | Teal | Dev server | A dev server paired with a live preview. The panel starts and owns its server, and trashing the panel stops it. See Dev Preview. |
| Review | Violet | No | The Review Hub bound to one worktree, so a diff sits next to the agent producing it. |
| File Viewer | Amber | No | One file, read as source, rendered, a diff or media. See File Viewer. |
| File Browser | Cyan | No | A tree plus folder listing for a worktree, scratch workspace, or plain project folder. See File Browser. |
| Diff Viewer | Green | No | A 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.
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.
| Presentation | What it is |
|---|---|
| Grid | The main content area. This is where work happens. |
| Dock | The 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. |
| Dialog | A 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.
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.
| Dockable | Not dockable |
|---|---|
| Terminal, Browser, Dev Preview, File Viewer, File Browser | Review, 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.
| Action | Shortcut |
|---|---|
| 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
| Action | Shortcut |
|---|---|
| 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.
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.
Navigating tabs
| Action | Shortcut |
|---|---|
| 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.
Panel Grid Layout
Pick a layout strategy in Settings > Panel grid > Layout, under Grid layout:
| Strategy | Behavior |
|---|---|
| Automatic (default) | Columns are chosen from the available width, not the panel count. |
| Fixed columns | Lock to a Number of columns (1–10). |
| Fixed rows | Lock 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:
- 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.
- Resume: a one-line shortcut back into a closed agent session.
- Recipes: run a saved workspace setup straight from here. See Recipes.
- Project pulse: the worktree's recent activity. See Project Pulse.
- Tips: a rotating hint, shown once you've launched an agent at least once.
- 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.
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.
| Owner | Set by | Behavior |
|---|---|---|
| Default | Nobody, the starting state | Derived from live runtime identity. Flips as detection promotes or demotes an agent, and composes in the agent's observed task title. |
| Custom | Automation: a preset, a launch name, an MCP or Assistant rename | Frozen against detection rewrites. Task composition still applies, and a later automation rename can replace it. |
| User | You, by renaming the panel | Fully 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.