Skip to main content

Configuration, precedence and environment ownership

Configuration belongs to a specific product, OS user, provider surface and component. There is no safe universal instruction to copy one machine's whole configuration into another environment.

Configuration domains​

DomainExamplesOwnership
Application preferencesViews, selected providers, literal formattingPer-user application
Native runtimeLocal interface, service wiring, Relay choiceRuntime/consumer policy and private owner state
Account authorityHTTPS site/endpoints and client identityNative account component; deployment overrides can apply
Provider integrationMCP registration, plugin, extension, managed profileExact declared provider-owned scopes
SSHAlias/user/port/key selection and host keysOpenSSH/user configuration
A2AEndpoint/card, authentication, bind/TLS/public originSelected service/client configuration
UpdateChannel, verified active/previous worker stateSigned updater/producer contract
Connected-client UITheme, language, terminal/history preferencesSelected mobile/client application

Requested versus active state​

A saved setting is not necessarily active behavior. A runtime status can report a requested configuration while its feature owner remains inactive. The reviewed native Core explicitly distinguishes requested MCP/browser-tools configuration from active host-service ownership.

Do not infer that browser automation, a public listener or provider access is enabled merely because a JSON field exists. Use authoritative feature/capability and installed status.

Overrides and persistence​

The Windows Relay preference is persisted in native state; POSIX runtime configuration retains its own saved choice. Explicit false must not be replaced by an automatic “recovery” enablement.

Account deployment environment overrides can take precedence over local account settings. Report the effective source of configuration without exposing credentials.

Paths differ between Windows profile state, Mac Application Support and Linux state/data roots. Supported overrides and identity-preserving relocation are not permission to bypass private-path or owner admission.

Change safety​

Read a preference locally when inspecting status. Account refresh, peer verification, update checking, migration and installation can have network or mutation side effects and should not be mislabeled as passive reads.

Before changing configuration, identify the existing value, intended effective value, affected consumer and recovery scope. Preserve unknown extension fields where the state contract requires them.

Do not edit a whole provider configuration to remove one owned entry, copy passwords into environment variables for a UI flow or rerun uncertain operations to regenerate a receipt.

See network defaults, credentials, observability and recovery.