Module config_file 

Config file support: ~/.recursive/config.toml

Priority chain: CLI flag > env var > config file > hardcoded default. The config file is optional — if absent, we gracefully fall back.

Structs

AgentSection

[agent] section.

FileConfig

Top-level deserialized structure of config.toml.

PermissionsSection

[permissions] section. Wire-compatible with crate::permissions::PermissionsConfig but lives here so config loading does not couple to that crate.

ProviderSection

[provider] section.

Functions

config_file_path

Return the path to the global config file: ~/.recursive/config.toml. Returns None if the home directory cannot be determined.

load_layered_permissions

Load layered permissions from user config and project config.

set_value

Write a dotted key=value to ~/.recursive/config.toml. Supports dotted keys like “provider.model”, “agent.max_steps”. Creates the file and parent directory if needed.