Skip to main content
Configuration moves through four stages: an administrator saves an organization policy, the Control API versions it, the authenticated client receives a personalized response, and the CLI reconciles harness-specific overlays.

Policy and runtime values

The dashboard owns managed harness settings, MCP entries, and extension packages. The mounted blue.yaml owns allowed harnesses, session-upload policy, the gateway section, and the optional curated package catalog. The Control API binds inference access to the source OAuth session while keeping the provisioned gateway credential server-side.
The Control API projects gateway.type into policy and adds gateway.proxy_url and the runtime-only gateway.token only to the delivered client response. Server credentials never enter the governance document. The token is a session-bound inference JWT and is never persisted by the Control API. The gateway has no model field; each agent uses its managed model when present or leaves model selection to the agent. gateway.provisioner.type selects the built-in LiteLLM implementation or the pinned executable. Gateway-specific key models, teams, budgets, resets, and API behavior belong in that implementation, not in blue.yaml.

Revisions and caching

Every successful dashboard save creates a new immutable revision. Clients cache the most recently fetched response and honor ttl_seconds. A running governed wrapper watches the optional server-sent revision stream and displays a desktop notification when a restart is needed; older or BYO services fall back to a 60-second check. The active agent is never interrupted or rewritten. Login only stores authentication. Run blue apply or blue daemon to keep the default agent current; another agent is reconciled when explicitly launched through Blue.

Merge behavior

Reconciliation never rewrites the configuration files you own, and it rebuilds the files Blue owns from scratch each time. See Managed configuration for which files fall on each side, what a governed launch inherits from yours, and the full list of merge rules. Version-aware reconciliation resolves the installed native CLI to a maintained renderer before any files are changed. See Harness version compatibility for pinning, breaking boundaries, and package variants, or Governance configuration for the complete shape.