Skip to main content

Overview

The settings.yml file provides persistent file-based configuration. It lives at .profclaw/settings.yml relative to your project root (or $DATA_DIR/settings.yml). Create it during setup:
Or manually create the file:

Full Schema Reference

Environment Variable Interpolation

Use ${VAR_NAME} syntax to reference environment variables in settings.yml:
This keeps secrets out of the configuration file.

Validating Configuration

profClaw validates settings.yml against a Zod schema on startup. Check your config:

Precedence

When the same setting is defined in multiple places:
  1. Environment variable wins over settings.yml
  2. settings.yml wins over built-in defaults
  3. CLI flags win over everything (for that invocation)
Example: