Configuration
Global and project-level configuration options.
Daemon-wide State
Default location: ~/.local/share/sourceprep/ on Mac and Linux. Override with the PREP_DATA_DIR environment variable (must be an absolute path).
This directory holds the daemon's SQLite stores, registry, audit log, and standalone-mode project indexes. You typically edit settings via the Dashboard — manual edits are rarely needed.
Pre-Phase-113 installs had state split between ./prep_data/ (CWD-relative) and the XDG location. Old layouts are auto-migrated on first daemon startup; the sentinel file .migrated_from_cwd records the migration.
Project Config
Stored in the internal SQLite database (managed via CLI/Dashboard). Per-project policy (include/exclude globs, path weights) is persisted torepo_policy.json inside the project's index directory.
Excluding files
SourcePrep respects your .gitignore automatically. For additional excludes, use the Project Settings panel in the dashboard (persisted torepo_policy.json) or the --exclude patterns via the API.
Environment Variables
You can override certain behaviors using environment variables.
| Variable | Values | Description |
|---|---|---|
| PREP_DATA_DIR | absolute path | Override the default daemon-state location. Defaults to ~/.local/share/sourceprep/. |
| PREP_ENGINE | auto | rust | python | Force the use of the Rust engine or Python fallback. Default: auto. |
| PREP_TIER | free | pro | team | enterprise | Override the license tier for testing/development. Requires PREP_DEV_MODE=1 to take effect. |
| PREP_DEV_MODE | 1 | Enable development mode — required for PREP_TIER to override the license tier. |