Promptrace
Local-first developer tool
Version control for LLM prompts.
Promptrace gives every prompt a history. Save versions, inspect word-level changes, and roll back safely without leaving your terminal or sending prompt data to a hosted service.
$ promptrace add qol/tutor/feedback
Added 'qol/tutor/feedback' -> v2
$ promptrace diff qol/tutor/feedback 1 2
You are an Arabic tutor.
Correct mistakes clearly gently.
+ Be encouraging.
$ promptrace rollback qol/tutor/feedback --to 1
Rolled back to v1 -> saved as v3
Overview
The audit trail your prompts were missing.
Prompts often live in source files, documents, and chat threads. Small edits can change an application's behavior, but the reason and the working version are easy to lose.
Promptrace brings a familiar version-control loop to prompt iteration: initialize a local store, add named prompts, inspect their history, compare versions, and restore one when needed.
Terminal workflow
A trace in three moves.
The repository does not include product screenshots, so this walkthrough uses the documented CLI flow directly.
$ promptrace add qol/tutor/feedback
Added 'qol/tutor/feedback' -> v2
$ promptrace diff qol/tutor/feedback 1 2
You are an Arabic tutor.
Correct mistakes clearly gently.
+ Be encouraging.
$ promptrace rollback qol/tutor/feedback --to 1
Rolled back to v1 -> saved as v3
Feature list
Small surface area. Complete prompt history.
- 01
Automatic versions
Every update creates the next numbered version, so yesterday's prompt never gets overwritten.
promptrace add <name> <prompt> - 02
Full prompt history
Review every saved version of a prompt, including when it was created and exactly what it contained.
promptrace log <name> - 03
Word-level diffs
Compare any two versions and see the language that was added, removed, or left unchanged.
promptrace diff <name> <v1> <v2> - 04
Non-destructive rollback
Restore an earlier prompt as a new version. The path back never erases the work that came after it.
promptrace rollback <name> --to <v> - 05
Namespaced prompts
Use readable paths like app/agent/system to keep prompts organized across products, roles, and workflows.
app/agent/system - 06
Project-local storage
A lightweight SQLite database lives with your project, ready to keep private or share through Git.
.promptrace/store.db
Privacy details
Your prompts stay in your project.
Promptrace is a local CLI with no account or hosted backend. Its source repository does not currently publish a separate privacy policy; these details reflect the documented storage model and implementation.
See how local storage worksLocal by default
Prompt history is stored in a SQLite database inside your project's .promptrace directory.
No account
The CLI has no sign-in flow, user profile, or authentication setup.
No Promptrace cloud
Saving, reading, diffing, and rolling back prompts happen on your machine.
Your sharing choice
Add .promptrace to .gitignore to keep history local, or commit it when your team should share it.
npm release · 0.1.1 · July 1, 2026
Install the CLI globally and start tracing in one command.
Open source
Promptrace is released under the MIT License. No standalone changelog is published yet; source history is available on GitHub.
Browse source historyGive your prompts a way back.
Install Promptrace and create a local prompt repository in seconds.