agent.configure_theme¶

agent.configure_theme(settings)

Set the theme policy (appearance, per-appearance syntect theme). The last call wins.

Parameters

• settings: {appearance: string?, contrast: string?, dark: {syntect_theme: string?}?, light: {syntect_theme: string?}?, probe_terminal: boolean?}
  • appearance — Which appearance to render; "auto" (the default) renders the dark preference until terminal probing can detect the background.
  • contrast — Whether to lift theme colors to a legibility floor; "auto" (the default) does, "off" trusts the theme's own contrast.
  • dark — The theme for a dark appearance.
  • light — The theme for a light appearance.
  • probe_terminal (default true) — Whether to query the terminal for its background color at startup. The probe runs when either appearance or contrast is "auto" (each consults the background), so a fixed appearance still probes for the contrast pass; set false to skip probing entirely.