obsidian-promptfire/docs/settings.md
luca-tty bc31779651 docs: update README and docs for export profiles, smart context, and snapshots
- Add export profiles, smart context, and snapshots to README features
- Document export profiles workflow and edge cases in output-targets.md
- Add per-target outputPath and intelligence settings to settings.md
- Add smart-context.md for context intelligence documentation
- Restructure history.md to include snapshots section
- Add new commands to getting-started.md
- Update repo URLs to GitHub

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 14:27:32 +01:00

86 lines
2.9 KiB
Markdown

# Settings Reference
Complete reference of all Promptfire settings.
## General
| Setting | Description | Default |
|---------|-------------|---------|
| **Context folder** | Folder with context files | `_context` |
| **Separator** | Text between files | `---` |
| **Include filenames** | Add `# === file.md ===` headers | On |
| **Show preview** | Preview before copying | Off |
| **Include active note** | Always append current note | Off |
| **Excluded files** | Files to skip | - |
## Context Sources
| Setting | Description |
|---------|-------------|
| **Freetext** | Static text snippets |
| **External File** | Absolute path to file outside vault |
| **Shell Command** | Command + args with timeout |
| **Position** | Prefix (before) or Suffix (after) vault content |
| **Show labels** | Add source name headers to output |
See [Context Sources](context-sources.md) for detailed usage.
## Prompt Templates
| Setting | Description |
|---------|-------------|
| **Name** | Display name |
| **Content** | Template with placeholders |
| **Default** | Use automatically when copying |
See [Templates](templates.md) for placeholders and conditionals.
## History
| Setting | Description | Default |
|---------|-------------|---------|
| **Enabled** | Save generated contexts | On |
| **Storage folder** | Where to store history | `.context-history` |
| **Max entries** | Limit stored entries | 50 |
| **Auto-cleanup** | Delete after X days | 30 |
See [History](history.md) for more details.
## Output Targets
| Setting | Description |
|---------|-------------|
| **Name** | Display name (e.g., "Claude", "GPT-4") |
| **Max tokens** | Token limit for truncation |
| **Format** | markdown, xml, or plain |
| **Strategy** | summarize-headers, drop-sections, truncate |
| **Wrapper** | Prefix/suffix text around content |
| **Output path** | Custom output folder for this target (overrides global) |
| **Primary** | Which target goes to clipboard |
| **Output folder** | Where to save secondary targets |
| **Active export profile** | Profile used by the multi-target export command |
## Export Profiles
| Setting | Description |
|---------|-------------|
| **Name** | Display name for the profile |
| **Description** | Optional description |
| **Targets** | Which targets are included |
| **Primary target** | Which target's output goes to clipboard |
See [Output Targets](output-targets.md) for export profile details.
## Intelligence
| Setting | Description | Default |
|---------|-------------|---------|
| **Enabled** | Enable context intelligence | Off |
| **Token budget** | Max tokens for smart context | 50,000 |
| **Max notes** | Max related notes to consider | 50 |
| **Min score** | Minimum relevance score | 0.1 |
| **Signal weights** | Weights for links, tags, folder proximity, properties | Varies |
| **Link depth** | How many hops to follow (1-3) | 1 |
| **Exclude paths** | Folders to skip | `_context, .obsidian` |
See [Smart Context](smart-context.md) for details.