Module config_file

Expand description

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.
LimitsSection: [limits] section. Various runtime limits and thresholds.
PermissionsSection
ProviderSection: [provider] section.
SandboxSection: [sandbox] section. Lists additional directories the agent may reach beyond the primary workspace.
SearchSection: [permissions] section. Wire-compatible with crate::permissions::PermissionsConfig but lives here so config loading does not couple to that crate. [search] section. Web search provider configuration.
StuckSection: [stuck] section. Stuck detection thresholds.

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.
secrets_env_path: Path of the shell-sourceable secrets file. Mirrors the home-dir resolution in config_file_path (honours RECURSIVE_HOME for tests).
set_secret: Persist a secret (typically an API key) to a 0600 shell-sourceable env file. The binary does NOT read this file at runtime; the user is expected to source it from their shell rc so the secret is in the process env when recursive runs.
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.