Struct PawConfig 

pub struct PawConfig {

    pub default_cli: Option<String>,
    pub default_spec_cli: Option<String>,
    pub branch_prefix: Option<String>,
    pub mouse: Option<bool>,
    pub clis: HashMap<String, CustomCli>,
    pub presets: HashMap<String, Preset>,
    pub specs: Option<SpecsConfig>,
    pub logging: Option<LoggingConfig>,
    pub dashboard: Option<DashboardConfig>,
    pub broker: BrokerConfig,
    pub supervisor: Option<SupervisorConfig>,
    pub governance: GovernanceConfig,
    pub layout: Option<LayoutConfig>,
    pub opsx: Option<OpsxConfig>,
    pub mcp: McpConfig,
}

Top-level git-paw configuration.

All fields are optional — absent config files produce empty defaults.

Fields

default_cli: Option<String>

Default CLI to use when none is specified.

default_spec_cli: Option<String>

Default CLI for --from-specs (bypasses picker when set).

branch_prefix: Option<String>

Prefix for spec-derived branch names (default: "spec/").

mouse: Option<bool>

Whether to enable tmux mouse mode for sessions.

clis: HashMap<String, CustomCli>

Custom CLI definitions keyed by name.

presets: HashMap<String, Preset>

Named presets keyed by name.

specs: Option<SpecsConfig>

Spec scanning configuration.

logging: Option<LoggingConfig>

Session logging configuration.

dashboard: Option<DashboardConfig>

Dashboard configuration.

broker: BrokerConfig

HTTP broker configuration.

supervisor: Option<SupervisorConfig>

Supervisor mode configuration.

governance: GovernanceConfig

Governance document path pointers.

All sub-fields are optional. Absence is equivalent to an empty [governance] section; v0.4 configs (no [governance] at all) load with GovernanceConfig::default() here.

layout: Option<LayoutConfig>

Layout configuration for git-paw-managed tmux sessions.

Absent [layout] (v0.5.0 and earlier configs) loads as None, which PawConfig::border_affordances_enabled resolves to the default (affordances on).

opsx: Option<OpsxConfig>

opsx (OpenSpec) integration configuration.

Absent [opsx] (v0.5.0 and earlier configs) loads as None, which PawConfig::role_gating_mode resolves to the default (RoleGatingMode::Warn).

mcp: McpConfig

MCP server configuration.

Absent [mcp] (v0.6.0 and earlier configs) loads as McpConfig::default (name: None), so the MCP server advertises the default "git-paw" identity and pre-existing configs round-trip unchanged.

Implementations

impl PawConfig

pub fn merged_with(&self, overlay: &Self) -> Self

Returns a new config that merges overlay on top of self.

Scalar fields from overlay take precedence when present. Map fields are merged with overlay entries winning on key collisions.

pub fn role_gating_mode(&self) -> RoleGatingMode

Resolves the effective opsx role-gating mode for this config, defaulting to RoleGatingMode::Warn when [opsx] or its role_gating field is absent.

pub fn border_affordances_enabled(&self) -> bool

Resolve whether the border affordances should be applied, defaulting to true when the [layout] section or its border_affordances field is absent.

pub fn mcp_server_name(&self) -> String

Resolves the effective MCP server identity advertised in the initialize handshake’s serverInfo.name.

Returns the configured [mcp].name when set, otherwise the default "git-paw".

pub fn get_preset(&self, name: &str) -> Option<&Preset>

Returns a preset by name, if it exists.

pub fn get_dashboard(&self) -> Option<&DashboardConfig>

Returns the dashboard configuration, if it exists.

Trait Implementations

impl Clone for PawConfig

fn clone(&self) -> PawConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PawConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PawConfig

fn default() -> PawConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PawConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PawConfig

impl PartialEq for PawConfig

fn eq(&self, other: &PawConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PawConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PawConfig