zidane-ui/settings/headless

A provider's row on Settings › Accounts, as a deep link's focus names it (SettingsShell's initialFocus).

A provider's API key field on Settings › Accounts, as a deep link's focus names it: the row opens on its key form.

Creates a monitor over a host.

Creates a resource over read.

What a page or row says under its title: on a server's settings (host, its name) its server wording when it has one, else its description.

After adding a server: the allowlist with it turned on, or undefined to leave the settings alone. Only a server that wasn't listed before is turned on (an edit keeps its toggle), and only when the list is known. Same rule as the TUI and a server's mcp.upsert.

The tools of a server that are on (disabledMcpTools is a deny list).

The names that are on.

0.4 ms, 38 ms, 2.1 s.

512 KB, 84 MB, 1.4 GB.

12.3% under 100, 140% above (several cores).

Whether a provider holds more than one stored credential, so there is a choice of which one is in use (the TUI's expandable auth rows).

Whether a sample holds anything sessions or terminals launched.

Whether a page is drawn by one panel (rather than rows).

Whether a value is a SettingsError.

Keeps one resource per key (a folder, a skill), so every reader of the same key shares one read.

One entry per row a layout page shows: a catalog row with its keywords and a choice's option labels, a custom row's or a panel's own entries, an app action.

The shell's sections for layout pages, in order.

A list's length; undefined for an answer that isn't a list (a server too old, a failed read).

The badge of a server. A refused key or a failed connection comes from the last test; a sign-in in progress (live) or a sign-in problem wins.

How a server runs now, from the host's instances: null when none runs. Retired processes count only while no fresh one runs (they close soon).

What a removal writes: the server out of enabledMcps, disabledMcpTools and mcpSharing, so a later server of the same name starts from the defaults. Empty when none names it.

A server whose process the host may share between sessions: a stdio server the host says runs on it (scope: 'host'). Remote and context servers run per session.

Whether a server shares one process: the mcpSharing setting, else its config, else yes.

mcpSharing with one server's choice set.

Nests processTree's rows (each parent before its children).

The option after current in a choice's cycle (the first one after the last, or for an unknown value).

One value per sample, for a sparkline.

The processes as two trees, the app's own and what was launched: a launched tree's roots are what a session or a terminal started.

The processes as a tree, each parent before its children, siblings busiest first.

The entries every term of query matches, in index order; none for a blank query.

The search index of the shell's sections: each section's search entries, or the section itself (title, description, keywords) when it has none, then extra (entries an app adds, e.g. extension options).

The processes per session, busiest first: each session's own tree.

How many settings a page holds, as this table describes it (the rail's count): a page of rows, each table row and each part of a custom row, actions aside; a panel, the table settings it draws and the rows its search entries name (those with a key). Pages that list things (skills, servers…) count those from their data instead.

A server of a host's catalog (a zidane-server's catalog.mcps) as MCP servers lists it: its sign-in state, tools and last test from status (an older host sends none: idle, untested). Removable when it is the host user's (mcp.remove edits that file only).

Each page's count: a list page's length from lists, a page of rows its settings. Zero and unknown counts are left out.

layoutSearchEntries for every page, each hit on its page.

Whether a page, section or row is offered: everything but localOnly parts while editing a server, Spaces included when the app's spaces are the server's.

The allowlist after turning name on or off.

disabledMcpTools after turning one tool on or off. Names the server no longer lists drop out; an empty list drops the server, an empty map is undefined.

Wraps whatever a host call threw as a SettingsError.

The pages this modal offers: Hosts needs remote hosts on, and while it edits a server the pages (and sections and rows, see shown) composing this computer's files drop out.

Default value of every setting.

The default English strings of the settings components.

Table choices no page places: TUI-only (targetFps) or drawn by Appearance (theme).

Samples kept: 5 minutes at the desktop app's 2 s.

The catalog's choices by key.

The catalog's choices, in display order.

Every page: the rail's entries in order, then the sub-pages (each listed under its parent). Extensions is an entry of its own, after Agent: the extensions' settings entries list under it (useExtensionSettingsSections). One flat literal: the website's evaluator skips spreads.

The catalog's toggles by key.

The catalog's toggles, in display order.

What a layout page's entries depend on.

Options for layoutSections.

One message channel's counters.

Whole-GPU use: every app's.

A function a profile spent time in.

The host's event-loop delay over the last interval, ms.

A view's window on the host's samples.

What a monitor holds.

One OS thread of a process (no name on macOS).

One process of the app, its daemon, or a program either started.

The MCP server a process runs.

A process with the processes it started, for a tree that opens one level at a time.

A process with its depth in the tree, for an indented list.

The session a process runs for.

A recorded profile, saved where path says.

Why a profile wasn't recorded: busy (another profile or a debugger holds the target) or failed.

One sample.

What one session's processes use.

Where long frames (over 50 ms) spent their time: one script and function, summed.

A thread the app can name.

CPU and memory, summed.

Why a host's figures can't be watched: unavailable (the host can't say: a server too old for it), refused (the connection's token may not: performance needs an admin token), failed (anything else, detail says).

A host action's row: the host owns the flow (a full modal), the layout places it.

One catalog's entries.

A choice row of the catalog: a setting with a few values, cycled.

What a copy did: by name.

What the host found in ~/.claude.

Importing a Claude Code setup on the host.

What to import.

What an import did.

One credential source of a provider. Never a secret.

A model a provider's decisions endpoint serves, with whether the host's credentials can use it.

Where new sessions run: the environment kinds and their settings.

A settings read or write that did not happen, worded by the labels (settingsError).

An extension the host discovered.

An action an extension declares (registerConfigItem type 'action'); it runs on the host.

What a run did: its message, and the config patch it set (already validated by the host).

An action's passive probe.

An extension to scaffold.

A scaffolded extension.

An extension to install.

Extensions on the host's disk, for one folder.

A file the host reads and writes with a guard on its modification time.

The settings host.

A host's catalogs as the host itself reports them (a zidane-server's catalog.*), each entry with the host's enabled state; the enabled lists are its settings (update). Its MCP servers are the mcp group's.

What a session's agent is loaded with.

What a SettingsResource holds now.

The host's log funnel.

The MCP servers of a folder (Settings › MCP servers). cwd is the folder ('': the user's servers only). Turning a server or one of its tools on and off is the settings document's (enabledMcps, disabledMcpTools).

A running process of a stdio server, as the host's pool holds it.

What a server's process badge says: one shared process and how many sessions hold it, or one per session.

An MCP server a folder's agents can use. Secret values never come back.

How a server answered its last test: ok connected and listed its tools; needs-auth refused with no key of its own (a sign-in fixes it); token-rejected refused the key it sends; error anything else.

A tool an MCP server lists.

The model rows' host calls. Each one left out hides what needs it.

How a model test went: one tiny request with the host's credentials.

A page one panel component draws; search stands in for its rows, which it loads lazily.

Opening a path of the host in another app.

The host's performance figures (Settings › Performance, the overlay).

An Agent Plugin the host discovered.

Agent Plugins on the host's disk, for one folder.

A provider and its sign-in state, as the host reports it. Never a secret.

A configuration field a provider asks for instead of an API key (an endpoint, a project id).

The providers a host's agents use (Settings › Accounts). cwd is the folder whose extension providers count ('': built-ins only).

A value the host reads and keeps current: get returns the same object until it changes.

Options for createSettingsResource.

One search entry inside a section.

One search result: an entry and the section it lands on.

A page of sections of rows.

What a browser sign-in is for.

Skills to install from one source.

Skills on the host's disk, for one folder (its project scope plus the user's).

A toggle row of the catalog.

The settings whose value is a boolean: what a toggle row may name.

invoke: a request timed to its answer; send: a message to the host; push: a message from it.

Whose cost a process is. app: the app's own (its processes, its daemon, the servers and helpers they run). launched: what a session's commands, a background task or a terminal started, and everything under it.

What a process is to the app.

A profile, or why there is none.

What a CPU profile records: the host's main process, or this window.

Host actions (SettingsAction.id, wired by the app): a row that opens a flow of its own.

What can be installed from a spec on a host.

Which of a host's catalogs.

Rows that aren't a table toggle or choice: a model picker, or the agent defaults.

The settings document as the host holds it.

The settings keys that hold an enabled allowlist.

Why the settings could not be read or written.

What a guarded write did.

Where an install goes: the project's folder or the user's.

The shape of the settings label dictionary.

Where an MCP server's sign-in is.

What a server's badge says: its sign-in state, or how its last test failed. idle: no badge.

A page of the layout.

One titled section of a page of rows.

Pages drawn by one panel component, mounted on first visit and then kept alive (their async state survives).

What setPreferred promotes: a stored credential by key, or the first stored one of a kind.

One row of a section: a catalog key, a custom row the app draws, or an app action.

Status lines an app draws under a section (SettingsRowsPage's notes): the terminals' daemon, how the app updates.

Pages of rows.

Every page's id.

The rail's entries.