glab-config
glab config
Shared local configuration and client certificates
Repository-local config lives in the Git common directory (glab-cli/config.yml) and is shared across linked worktrees unless that worktree already has its own legacy glab-cli/config.yml, which keeps precedence. Approve the repository-wide effect of local changes; stack selection remains worktree-local. GLAB_PROXY overrides the per-host API proxy key; it is distinct from package-manager registry proxies.
client_cert accepts a PEM/DER certificate with client_key, or a PKCS#12 bundle with no client_key. client_key accepts PEM/DER PKCS#8, PKCS#1, or EC keys. client_cert_password / GLAB_CLIENT_CERT_PASSWORD decrypts a PKCS#12 bundle and is keyring-backed when use_keyring is true. Use protected certificate/key paths and an already securely provisioned password environment, never password values in config set argv or diagnostic output.
Host selection and output rendering
The configured host key is a fallback, not a constraint on repository remotes. Inside a repository, a remote on another host can select that host. Environment host selectors (GITLAB_HOST, GITLAB_URI, GL_HOST, or the corresponding CI auto-login source) remain authoritative; no matching remote produces an error rather than silently switching hosts. Explicit full-URL repository selectors carry their own host. This host-selection rule is separate from normal setting precedence: environment values, non-empty per-host settings/eligible keyring credentials, local config, global config, then defaults.
Environment credential precedence applies only to trusted hosts; a host supplied solely in a command argument receives no environment token. See glab-auth for default-host, configured-host, GITLAB_REPO, port, and CI rules. Host selection and credential eligibility are separate checks.
Global output color is controlled by GLAB_COLOR=auto|never|always or the global color config key. always/never override NO_COLOR; auto detects terminal output and honors legacy color environment behavior. There is no global --color CLI flag. glab mr diff --color is a separate command-specific option; label color flags set label metadata. For credential-free, uncolored help use GLAB_COLOR=never glab help <command>.
glamour_style defaults to auto and detects the terminal background; explicit dark, light, notty, and custom styles remain available. Existing seeded dark defaults can migrate once to auto; use an explicit environment style override when deterministic rendering matters. Help retains Fang's indented uppercase headings and can wrap or truncate examples. Preserve exact help output when capturing references, and use supported JSON output rather than parsing terminal formatting. Error text is displayed as written, so punctuation is not a stable parsing contract. Terminal Markdown preserves explicit hard line breaks (two trailing spaces or a backslash before a newline); soft line breaks still follow normal Markdown rendering. This affects display, not stored GitLab text or JSON payloads.