Settings
How Daintree's 20 global and 8 project settings tabs fit together: the scope switcher, the override-vs-inherit model, cross-scope search, and the sidebar indicators.
Open Settings with Command-, Control-, Control-, , or click the gear icon in the toolbar. The dialog is a left sidebar of grouped tabs and a content panel on the right. When a project is open, a scope switcher in the sidebar header toggles between Global and Project settings.
Settings split into two scopes:
- Global Settings apply to Daintree as a whole, regardless of which project is open. They cover 20 tabs across the General, Terminal, Assistant, Integrations, and Support groups.
- Project Settings cover 8 tabs and layer on top of the global values for one project only. They only exist while a project is open.
Opening Settings from the toolbar or the menu always lands on global scope, whichever tab you were last on there. Switching scope takes you to the tab you were last using in that scope, because the two scopes hold different tabs and dumping you on a mismatched one would just cost a click. A search result, or any action that deep-links a specific tab, opens directly on it in the right scope.
Override and inherit
Project settings do not replace global ones: they sit in front of them. Most project fields have a global default behind them, and the field tells you which one is in play. An overriding field carries a small marker next to its label and a rim on the input, and reveals a Reset to global button on hover. An inheriting field shows the inherited value in italics below the input. Clearing an overridden field reverts it to inherited, so most of the time you don't need the reset button at all.
That is the model for scalar fields. Environment variables use a related but distinct shape: a read-only inherited block above the editable project rows, with pills marking which inherited keys the project has taken over. Both are documented on the Project Settings page.
Search
With the Settings dialog focused, press Command-F Control-F Control-F or / to jump to the search field. Matching is fuzzy across every setting name, description, and keyword, so partial matches and minor typos still find the right result.
As you type, match count badges appear next to each sidebar tab showing how many results that tab holds. The content panel is replaced with a scrollable list of result cards. Each card leads with a scope chip (Global or Project) so you can see which scope the result lives in, then a breadcrumb path (Tab › Subtab › Section), the setting title with matches highlighted, and a description. A setting that depends on a disabled feature carries a Requires <feature> pill, so you know the click will land on a page gated behind an enable toggle.
Arrow keys move through results, Enter navigates. Esc clears the query; a second Esc blurs the search field.
The @modified filter
Type @modified (or the short alias @mod) in the search box to show only settings that differ from their defaults. It combines with keywords: scrollback @modified narrows to modified scrollback-related settings.
If nothing has been changed, the results area shows an empty state confirming everything is at its default.
@modified filter respects the active scope. In Global scope it shows changed global settings; in Project scope it shows changed project settings. The scope chip on each result card makes the difference clear.Sidebar indicators
Three kinds of marks can appear on a tab's icon in the sidebar. They're independent of which tab you have open, and they update live as you change settings.
- Green dot: at least one setting on that tab differs from its default. This is the modified indicator.
- Amber dot: the tab has reported a validation error. This is the validation badge, separate from the modified indicator.
- Match count badge: only visible while you're searching. Shows how many results the active query matches in that tab.
When a tab has both a modified setting and a validation error, the amber dot wins. The amber dot clears itself too: it disappears as soon as the underlying error resolves, or when you leave the tab.
Three tabs currently track modified state:
| Tab | Triggers the green dot when |
|---|---|
| General | Any Display subtab toggle differs from its default (Project Pulse off, Developer Tools on, or either Agent Highlights toggle on) |
| Panel Grid | Any Performance, Input, Layout, or Scrollback setting differs from its default |
| Appearance | Dock Density is set to Compact or Comfortable (the default is Normal) |
Nine tabs currently report a validation state: Appearance, Worktree, Environment, Code Forge, Voice Input, Portal, MCP Server, Daintree Assistant, and the project Worktree Setup tab. They raise it when their stored values or provider list fail to load, or when a field on them is invalid: an unparseable env key, a broken worktree path pattern. More tabs can opt in over time, so treat the amber dot as the general signal that something on that tab needs attention, not as a fixed list.