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). You can also place a .sourceprep/config.json in your project root to override settings for that specific repo.
.sourceprep/ignore
Works exactly like .gitignore. Use this to exclude files from indexing that you might want to keep in git (or local-only files not in gitignore).
# Example .sourceprep/ignore *.lock docs/generated/ legacy/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. |