Update README: document project-specific settings, add SettingsManager to SDK list

This commit is contained in:
Mario Zechner 2025-12-22 12:34:08 +01:00
parent 5d290f048e
commit e5f74a1ad9

View file

@ -652,7 +652,14 @@ export default factory;
### Settings File
`~/.pi/agent/settings.json` stores persistent preferences:
Settings are loaded from two locations and merged:
1. **Global:** `~/.pi/agent/settings.json` - user preferences
2. **Project:** `<cwd>/.pi/settings.json` - project-specific overrides (version control friendly)
Project settings override global settings. For nested objects, individual keys merge.
Global `~/.pi/agent/settings.json` stores persistent preferences:
```json
{
@ -847,7 +854,8 @@ The SDK provides full control over:
- Tools (built-in subsets, custom tools)
- Hooks (inline or discovered)
- Skills, context files, slash commands
- Session persistence
- Session persistence (`SessionManager`)
- Settings (`SettingsManager`)
- API key resolution and OAuth
**Philosophy:** "Omit to discover, provide to override." Omit an option and pi discovers from standard locations. Provide an option and your value is used.