How ertugrulmutlu/promptledger works
PromptLedger is a local-first prompt version-control tool: developers add and inspect prompt versions, compare or review changes, attach release labels and markers, and optionally record external evaluation results and apply regression gates. The CLI and Python API use a core ledger backed by SQLite; a local HTTP dashboard presents read-only prompt history and evaluation data. The graph preserves review, rendering, evaluation, and dashboard capabilities documented in the README. Several source excerpts are partial, so only evidenced calls are connected; dashboard browser/API wiring is documented at a high level.
Main entry points: core.py Ledger Operations · cli.py CLI · server.py HTTP Server · api.py Dashboard API
Components 19
User Interfaces
- CLI
src/promptledger/cli.py - Python API
src/promptledger/__init__.py - Legacy UI
src/promptledger/ui.py
Prompt Ledger
- Ledger Operations
src/promptledger/core.py - SQLite Store
src/promptledger/db.py - Version History
src/promptledger/core.py - Labels & Markers
src/promptledger/core.py - Search & Export
src/promptledger/core.py
Review & Evaluation
- Diff & Review
src/promptledger/core.py - Review Summaries
src/promptledger/review.py - Review Rendering
src/promptledger/render.py - Evaluation Runs
src/promptledger/evaluation.py - Regression Gates
src/promptledger/evaluation.py
Local Dashboard
- HTTP Server
src/promptledger/dashboard/server.py - Dashboard API
src/promptledger/dashboard/api.py - Dashboard Browser
src/promptledger/dashboard/static/app.js
Other components
- Developer
- Python Client
- Browser User
Connections 21
- Developer → CLI: runs commands
README.md - CLI → Ledger Operations: calls ledger
src/promptledger/cli.py - Python Client → Python API: calls API
README.md - Python API → Ledger Operations: exposes operations
src/promptledger/__init__.py - CLI → Legacy UI: launches optional UI
src/promptledger/cli.py - Ledger Operations → Version History: manages versions
README.md - Ledger Operations → Labels & Markers: manages pointers
README.md - Ledger Operations → Search & Export: supports queries
README.md - Ledger Operations → SQLite Store: reads and writes
src/promptledger/core.py - Ledger Operations → Diff & Review: compares versions
src/promptledger/core.py - Ledger Operations → Review Summaries: builds summaries
src/promptledger/core.py - Review Rendering → Review Summaries: renders results
src/promptledger/render.py - Ledger Operations → Review Rendering: uses renderers
src/promptledger/core.py - Ledger Operations → Evaluation Runs: records and compares
src/promptledger/core.py - Ledger Operations → Regression Gates: checks policies
README.md - Developer → HTTP Server: opens dashboard
README.md - HTTP Server → Dashboard API: routes requests
src/promptledger/dashboard/server.py - Dashboard API → Ledger Operations: queries ledger
src/promptledger/dashboard/api.py - Dashboard API → Evaluation Runs: lists evaluations
src/promptledger/dashboard/api.py - Browser User → Dashboard Browser: views workspace
README.md - HTTP Server → Dashboard Browser: serves static files
README.md