Module config 

Configuration file support.

Parses TOML configuration from global (~/.config/git-paw/config.toml) and per-repo (.git-paw/config.toml) files. Supports custom CLI definitions, presets, and programmatic add/remove of custom CLIs.

Structs

AutoApproveConfig

Configuration for the supervisor auto-approval feature.

BrokerConfig

HTTP broker configuration for agent coordination.

CustomCli

A custom CLI definition from config.

DashboardConfig

Dashboard configuration.

LoggingConfig

Session logging configuration.

PawConfig

Top-level git-paw configuration.

Preset

A named preset defining branches and a CLI to use.

SpecsConfig

Spec scanning configuration.

SupervisorConfig

Supervisor mode configuration.

Enums

ApprovalLevel

Approval level governing how much autonomy an agent has when operating on the repository.

ApprovalLevelPreset

Coarse-grained policy preset that maps onto a known AutoApproveConfig shape.

Functions

add_custom_cli

Adds a custom CLI to the global config.

add_custom_cli_to

Adds a custom CLI to the config at the given path.

approval_flags

Returns the CLI-specific permission flag for cli at the given approval level, or an empty string if the combination has no mapped flag.

generate_default_config

Returns a default config.toml string with sensible defaults and commented-out v0.2.0 fields for discoverability.

global_config_path

Returns the path to the global config file (~/.config/git-paw/config.toml).

load_config

Loads the merged configuration for a repository.

load_config_from

Loads merged config from an explicit global path and repo root.

load_repo_config

Loads only the repo-level configuration (.git-paw/config.toml).

remove_custom_cli

Removes a custom CLI from the global config.

remove_custom_cli_from

Removes a custom CLI from the config at the given path.

repo_config_path

Returns the path to a repo-level config file (.git-paw/config.toml).

save_repo_config

Saves a PawConfig to the repo-level config file (.git-paw/config.toml).