2.6 KiB
Context History & Snapshots
History
Track every context you generate over time.
Features
- Automatic saving - Every generated context is saved with a timestamp
- Search and filter - Find past contexts quickly
- Diff comparison - Compare versions to see what changed
- One-click restore - Copy any past context back to clipboard
- Configurable retention - Control storage limits and auto-cleanup
Settings
| 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 |
Usage
Ctrl+P > "Promptfire: View context history"
Browse, search, compare, and restore any previous context.
Context Diff
In iterative LLM workflows you don't want to paste the full vault context every time — only the files that changed. The context diff command compares per-file content hashes against the most recent export and copies only the delta.
Usage
Ctrl+P > "Promptfire: Copy context diff (changes since last export)"
How It Works
- Every normal export stores a content hash per file in the history entry
- The diff command finds the most recent history entry with hashes (the "baseline")
- Current files are hashed and compared against the baseline
- Only new and modified files are copied, tagged with
[NEW]or[MODIFIED]in the file header - The diff entry stores all current hashes, so it becomes the next baseline — enabling chained iterative diffs
Sources (freetext, file, shell) are always included fully since they're external.
Requirements
- History must be enabled (Settings > History > Enabled)
- At least one prior export with file hashes must exist (any normal copy after the update)
Edge Cases
| Scenario | Behavior |
|---|---|
| No baseline exists | Notice: "Run a normal context copy first" |
| No changes detected | Notice: "No changes since last export" |
| File renamed | Shows as new file + removed file |
| File deleted | Listed in removed count in the notice |
Snapshots
Snapshots save a context "recipe" — the exact combination of notes, settings, and template — so you can replay it later.
Usage
Ctrl+P > "Promptfire: View context snapshots"
Browse, replay, or delete saved snapshots. Replaying a snapshot re-reads the files with current content and re-applies the template, giving you a fresh context from the same recipe.
Snapshots are managed in Settings > History > Snapshots.