reprompt-cli 1.4.1__tar.gz → 1.6.0__tar.gz

{reprompt_cli-1.4.1 → reprompt_cli-1.6.0}/CHANGELOG.md

@@ -2,6 +2,109 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.6.0] - 2026-03-28
+
+### Added
+- **Agent workflow analysis** — `reprompt agent` detects error loops, tool call patterns, and session efficiency from existing session files. Zero config, zero instrumentation.
+- **Codex CLI adapter** — full support for OpenAI Codex CLI sessions (`~/.codex/sessions/`), including user/assistant turns, tool calls (shell + function), error detection with exit codes, and file path tracking. 9th adapter.
+- **Sensitive content detection** — `reprompt privacy --deep` scans stored prompts for API keys, JWT tokens, emails, IP addresses, passwords, env secrets, and home paths. All regex-based, zero network.
+- **Chrome Web Store extension** — `install-extension` now defaults to the published extension ID; `extension-status` shows the Chrome Web Store install link.
+- **Extension E2E tests** — 8 tests covering the full extension -> Native Messaging -> DB -> CLI pipeline across 3 sources.
+
+### Changed
+- **ConversationTurn model** — added `tool_names` and `error_text` fields for richer agent analysis (backward-compatible defaults)
+- **Claude Code adapter** — now extracts individual tool names (Read, Edit, Bash, etc.) from tool_use blocks, not just counts
+- **Suggestions** — `distill` now suggests `reprompt agent`; `agent` suggests `--loops-only` and `privacy --deep`
+- Tests: 1397 -> 1490+
+
+## [1.5.0] - 2026-03-25
+
+### Added
+- **Instant dashboard** — bare `reprompt` now shows a health overview: total prompts, sessions, avg score, top categories, recent activity. Zero-state guides new users; data-state gives at-a-glance intelligence
+- **Session type detection** — `distill` auto-classifies sessions (debugging, feature-dev, exploration, refactoring, config, learning) and adapts signal weights per type
+- **Hook suggestion throttle** — `reprompt scan` suggests `install-hook` only once, not every run
+
+### Changed
+- **Command consolidation (23 → 20)** — deprecated `library`, `recommend`, `trends` as standalone commands; functionality absorbed into `report --smart` and `style --trends` flags
+- **Signal quality improvements** — reduced false positives in position, length, and error_recovery signals for more accurate distillation
+- Tests: 1350 → 1397
+
+### Deprecated
+- `reprompt library` → use `reprompt report --smart`
+- `reprompt recommend` → use `reprompt insights`
+- `reprompt trends` → use `reprompt style --trends`
+
+## [1.4.1] - 2026-03-25
+
+### Added
+- **`compare --best-worst`** — auto-selects your highest and lowest scoring prompts from the database for instant comparison
+- **`style --trends`** — period-over-period style fingerprint comparison showing how your prompting patterns evolve
+
+## [1.4.0] - 2026-03-24
+
+### Added
+- **Context recovery** — `distill --export` generates a markdown summary of conversation context, ready to paste into a new session when context is lost
+- **`--full` mode** — exports all turns (not just important ones) for complete session records
+- **`--show-weights` / `--weights`** — transparent signal weighting so you can see and tune how importance is scored
+- **Template sub-app** — `reprompt template save|list|use` for managing reusable prompts
+- **Enhanced insights** — effectiveness scoring and similar prompt suggestions
+
+### Changed
+- **Command consolidation (27 → 23)** — deprecated `save`, `templates`, `use`, `effectiveness`, `merge-view` in favor of unified `template` and `insights` commands
+- Tests: 1250 → 1350
+
+### Deprecated
+- `reprompt save` → use `reprompt template save`
+- `reprompt templates` → use `reprompt template list`
+- `reprompt use` → use `reprompt template use`
+- `reprompt effectiveness` → folded into `reprompt insights`
+- `reprompt merge-view` → use `reprompt report --smart`
+
+## [1.3.1] - 2026-03-23
+
+### Added
+- **Actionable suggestions** — 5 core commands now show contextual "→ Try:" hints guiding users to the next useful command
+- **`--source` consistency** — all data commands support `--source` filtering
+
+### Fixed
+- System-injected XML prompts (starting with `<`) filtered from distillation input
+
+## [1.3.0] - 2026-03-23
+
+### Added
+- **Conversation distillation** — `reprompt distill` extracts the most important turns from AI conversations using 6-signal importance scoring: position, length, tool trigger, error recovery, semantic shift, uniqueness
+- **Full conversation parsing** — adapters now return both user and assistant turns (Claude Code and ChatGPT have full implementations; others fall back to user-only)
+- **Rule-based summaries** — `--summary` generates compressed conversation overviews without requiring an LLM
+- **Flexible session selection** — `--last N` for recent sessions, `--threshold` to control importance cutoff
+- **Output options** — `--json`, `--copy` for pipeline integration
+
+### Changed
+- Tests: 1153 → 1217
+
+## [1.2.0] - 2026-03-23
+
+### Added
+- **4-layer prompt compression** — `reprompt compress` optimizes prompts through character normalization, phrase simplification (40+ zh / 50+ en rules), filler word deletion (jieba-aware), and structure cleanup
+- **Compressibility in PromptDNA** — every scanned prompt gets a compressibility score, visible in insights and HTML dashboard
+- **`--copy` flag** — compressed output copies to clipboard
+
+### Changed
+- Tests: 1046 → 1153
+
+### Research
+- Compression rules based on LLMLingua (Microsoft), CompactPrompt, TSC, stopwords-iso/zh, Prompt Report 2406.06608
+
+## [1.1.0] - 2026-03-22
+
+### Added
+- **Privacy exposure analysis** — `reprompt privacy` shows what data you've sent to which AI tools: file paths, error messages, code snippets, personal identifiers
+- **Per-adapter breakdown** — see privacy exposure grouped by source (Claude Code vs ChatGPT vs Cursor etc.)
+- **Instruction repetition scoring** — detects and scores redundant instructions within prompts
+- **Per-source insights** — `reprompt insights --source` shows patterns specific to each tool
+
+### Changed
+- Tests: 923 → 1046
+
 ## [1.0.0] - 2026-03-16
 
 ### Changed

{reprompt_cli-1.4.1 → reprompt_cli-1.6.0}/CLAUDE.md

@@ -18,7 +18,7 @@ uv run python -m build                     # build wheel
 
 ```
 src/reprompt/
-├── cli.py              # Typer CLI (scan, import, report, search, library, recommend, demo, status, purge, install-hook, install-extension, extension-status, score, compare, insights, digest, style, template [save|list|use], privacy, compress, distill) + plugin loading
+├── cli.py              # Typer CLI (scan, import, report, search, demo, status, purge, install-hook, install-extension, extension-status, score, compare, insights, digest, style, template [save|list|use], privacy, compress, distill, agent, lint, wrapped, telemetry, mcp-serve) + bare `reprompt` dashboard + plugin loading
 ├── config.py           # pydantic-settings, env vars (REPROMPT_ prefix) + TOML config
 ├── demo.py             # Built-in demo data generator (no network required)
 ├── core/
@@ -40,13 +40,16 @@ src/reprompt/
 │   ├── persona.py       # 6 prompt personas (Architect/Debugger/Explorer/Novelist/Sniper/Teacher)
 │   ├── wrapped.py       # WrappedReport dataclass + build_wrapped(db) aggregation
 │   ├── privacy.py       # Privacy metadata registry + exposure summary per adapter
+│   ├── privacy_scan.py  # Sensitive content detection (API keys, tokens, PII) via regex
 │   ├── compress.py      # 4-layer prompt compression (char norm + phrase simplify + filler delete + structure cleanup)
-│   ├── suggestions.py   # Command journey suggestions ("→ Try:" hints for 5 core commands)
+│   ├── suggestions.py   # Command journey suggestions ("→ Try:" hints for 7 core commands)
 │   ├── conversation.py  # ConversationTurn, Conversation, DistillResult dataclasses
-│   └── distill.py       # 6-signal importance scoring + filtering + summary generation
+│   ├── distill.py       # 6-signal importance scoring + filtering + summary generation
+│   └── agent.py         # Agent workflow analysis: error loop detection, tool distribution, efficiency
 ├── adapters/
 │   ├── base.py         # BaseAdapter ABC + parse_conversation() default
-│   ├── claude_code.py  # Claude Code JSONL parser
+│   ├── claude_code.py  # Claude Code JSONL parser (full conversation + tool names)
+│   ├── codex.py        # Codex CLI JSONL rollout parser (full conversation + shell/function calls)
 │   ├── openclaw.py     # OpenClaw JSON parser (supports ~/.openclaw/ + legacy ~/.opencode/)
 │   ├── cursor.py       # Cursor IDE .vscdb parser (cursorDiskKV + legacy ItemTable)
 │   ├── aider.py        # Aider markdown chat history parser (.aider.chat.history.md)
@@ -87,7 +90,8 @@ src/reprompt/
     ├── wrapped_terminal.py # Rich Prompt Wrapped report rendering
     ├── wrapped_html.py     # Self-contained HTML share card (dark theme)
     ├── compress_terminal.py # Rich output for compress command
-    └── distill_terminal.py  # Rich output for distill command
+    ├── distill_terminal.py  # Rich output for distill command
+    └── agent_terminal.py   # Rich output for agent workflow report
 ```
 
 ## Data Flow
@@ -124,7 +128,7 @@ reprompt-extension (private)   ← Browser extension: Chrome/Firefox prompt capt
 - Pattern upsert (not clear+re-insert) for stable IDs
 - Prompts starting with `<` are filtered (system-injected XML)
 - Config: env vars (REPROMPT_ prefix) > TOML (~/.config/reprompt/config.toml) > defaults
-- Tests: pytest, 1295 tests, 95% coverage target
+- Tests: pytest, 1490+ tests, 95% coverage target
 
 ## Prompt Science Engine
 

reprompt_cli-1.6.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: reprompt-cli
+Version: 1.6.0
+Summary: Discover, analyze, and optimize your prompts from AI coding sessions
+Project-URL: Homepage, https://github.com/reprompt-dev/reprompt
+Project-URL: Repository, https://github.com/reprompt-dev/reprompt
+Project-URL: Issues, https://github.com/reprompt-dev/reprompt/issues
+Project-URL: Changelog, https://github.com/reprompt-dev/reprompt/blob/main/CHANGELOG.md
+License: MIT
+License-File: LICENSE
+Keywords: ai,analytics,claude-code,cli,llm,prompt
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: scikit-learn>=1.4
+Requires-Dist: typer>=0.9
+Provides-Extra: chinese
+Requires-Dist: jieba>=0.42; extra == 'chinese'
+Provides-Extra: dev
+Requires-Dist: jieba>=0.42; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: local
+Requires-Dist: sentence-transformers>=2.0; extra == 'local'
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=2.0; extra == 'mcp'
+Provides-Extra: ollama
+Requires-Dist: requests>=2.31; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# `re:prompt`
+
+**Prompt Intelligence for AI power users** -- understand, optimize, and manage your AI conversations.
+
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen)](https://github.com/reprompt-dev/reprompt/actions)
+[![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/reprompt-dev/reprompt)
+
+---
+
+## See it in action
+
+```bash
+$ pip install reprompt-cli
+$ reprompt
+  ╭─ Prompt Dashboard ─────────────────────────────────────────╮
+  │  Prompts: 1,063 (295 unique)   Sessions: 890              │
+  │  Avg Score: 68/100             Top: debug (31%), impl (24%)│
+  │  Sources: claude-code, cursor, chatgpt                     │
+  ╰────────────────────────────────────────────────────────────╯
+
+$ reprompt score "Fix the auth bug in src/login.ts where JWT expires"
+  Score: 74/100
+  Structure: 18/25 | Context: 22/25 | Position: 15/20 | Repetition: 9/15 | Clarity: 10/15
+  Tip: Add the error message for +15% accuracy
+
+$ reprompt distill --last 3 --summary
+  Session: feature-dev (42 turns, 18 important)
+  Key moments: initial spec → auth module → test failures → JWT fix → passing
+  Context: "Building auth system with JWT refresh tokens for Express API"
+
+$ reprompt compress "请帮我看一下这个代码，就是那个 login 的那个文件，好像有点问题"
+  Before: 31 tokens → After: 15 tokens (52% saved)
+  "看一下 login 文件的问题"
+```
+
+## What it does
+
+### Analyze
+
+| Command | Description |
+|---------|-------------|
+| `reprompt` | Instant dashboard -- prompts, sessions, avg score, top categories |
+| `reprompt scan` | Auto-discover prompts from 9 AI tools |
+| `reprompt score "prompt"` | Research-backed 0-100 scoring with 30+ features |
+| `reprompt compare "a" "b"` | Side-by-side prompt analysis (or `--best-worst` for auto-selection) |
+| `reprompt insights` | Personal patterns vs research-optimal benchmarks |
+| `reprompt style` | Prompting fingerprint with `--trends` for evolution tracking |
+| `reprompt agent` | Agent workflow analysis -- error loops, tool patterns, session efficiency |
+
+### Optimize
+
+| Command | Description |
+|---------|-------------|
+| `reprompt compress "prompt"` | 4-layer prompt compression (50%+ token savings typical) |
+| `reprompt distill` | Extract important turns from conversations with 6-signal scoring |
+| `reprompt distill --export` | Recover context when a session runs out -- paste into new session |
+| `reprompt lint` | Prompt quality linter with GitHub Action support |
+
+### Manage
+
+| Command | Description |
+|---------|-------------|
+| `reprompt privacy` | See what data you sent where -- file paths, errors, PII exposure |
+| `reprompt privacy --deep` | Scan for sensitive content: API keys, tokens, passwords, PII |
+| `reprompt report` | Full analytics: hot phrases, clusters, patterns (`--html` for dashboard) |
+| `reprompt digest` | Weekly summary comparing current vs previous period |
+| `reprompt wrapped` | Prompt DNA report -- persona, scores, shareable card |
+| `reprompt template save\|list\|use` | Save and reuse your best prompts |
+
+## Prompt Science
+
+Scoring is calibrated against 4 research papers covering 30+ features across 5 dimensions:
+
+| Dimension | What it measures | Paper |
+|-----------|-----------------|-------|
+| **Structure** | Markdown, code blocks, explicit constraints | Prompt Report 2406.06608 |
+| **Context** | File paths, error messages, technical specificity | Google 2512.14982 |
+| **Position** | Instruction placement relative to context | Stanford 2307.03172 |
+| **Repetition** | Redundancy that degrades model attention | Google 2512.14982 |
+| **Clarity** | Readability, sentence length, ambiguity | SPELL (EMNLP 2023) |
+
+All analysis runs locally in <1ms per prompt. No LLM calls, no network requests.
+
+## Conversation Distillation
+
+`reprompt distill` scores every turn in a conversation using 6 signals:
+
+- **Position** -- first/last turns carry framing and conclusions
+- **Length** -- substantial turns contain more information
+- **Tool trigger** -- turns that cause tool calls are action-driving
+- **Error recovery** -- turns that follow errors show problem-solving
+- **Semantic shift** -- topic changes mark conversation boundaries
+- **Uniqueness** -- novel phrasing vs repetitive follow-ups
+
+Session type (debugging, feature-dev, exploration, refactoring) is auto-detected and signal weights adapt accordingly.
+
+## Supported AI tools
+
+| Tool | Format | Auto-discovered by `scan` |
+|------|--------|--------------------------|
+| Claude Code | JSONL | Yes |
+| Codex CLI | JSONL | Yes |
+| Cursor | .vscdb | Yes |
+| Aider | Markdown | Yes |
+| Gemini CLI | JSON | Yes |
+| Cline (VS Code) | JSON | Yes |
+| OpenClaw / OpenCode | JSON | Yes |
+| ChatGPT | JSON | Via `reprompt import` |
+| Claude.ai | JSON/ZIP | Via `reprompt import` |
+
+## Installation
+
+```bash
+pip install reprompt-cli            # core (all features, zero config)
+pip install reprompt-cli[chinese]   # + Chinese prompt analysis (jieba)
+pip install reprompt-cli[mcp]       # + MCP server for Claude Code / Continue.dev / Zed
+```
+
+### Quick start
+
+```bash
+reprompt scan                       # discover prompts from installed AI tools
+reprompt                            # see your dashboard
+reprompt score "your prompt here"   # score any prompt instantly
+reprompt distill --last 1           # distill your most recent conversation
+```
+
+### Auto-scan after every session
+
+```bash
+reprompt install-hook               # adds post-session hook to Claude Code
+```
+
+### Browser extension
+
+Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser:
+
+1. **Install the extension** from [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn)
+2. **Connect to the CLI:** `reprompt install-extension`
+3. **Verify:** `reprompt extension-status`
+
+Captured prompts sync locally via Native Messaging -- nothing leaves your machine.
+
+## Privacy
+
+- All analysis runs locally. No prompts leave your machine.
+- `reprompt privacy` shows exactly what you've sent to which AI tool.
+- Optional telemetry sends only anonymous 26-dimension feature vectors -- never prompt text.
+- Open source: audit exactly what's collected.
+
+[Privacy policy](https://getreprompt.dev/privacy)
+
+## Links
+
+- **Website:** [getreprompt.dev](https://getreprompt.dev)
+- **Chrome Extension:** [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn)
+- **PyPI:** [reprompt-cli](https://pypi.org/project/reprompt-cli/)
+- **Changelog:** [CHANGELOG.md](CHANGELOG.md)
+- **Privacy:** [getreprompt.dev/privacy](https://getreprompt.dev/privacy)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

reprompt_cli-1.6.0/README.md

@@ -0,0 +1,170 @@
+# `re:prompt`
+
+**Prompt Intelligence for AI power users** -- understand, optimize, and manage your AI conversations.
+
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen)](https://github.com/reprompt-dev/reprompt/actions)
+[![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/reprompt-dev/reprompt)
+
+---
+
+## See it in action
+
+```bash
+$ pip install reprompt-cli
+$ reprompt
+  ╭─ Prompt Dashboard ─────────────────────────────────────────╮
+  │  Prompts: 1,063 (295 unique)   Sessions: 890              │
+  │  Avg Score: 68/100             Top: debug (31%), impl (24%)│
+  │  Sources: claude-code, cursor, chatgpt                     │
+  ╰────────────────────────────────────────────────────────────╯
+
+$ reprompt score "Fix the auth bug in src/login.ts where JWT expires"
+  Score: 74/100
+  Structure: 18/25 | Context: 22/25 | Position: 15/20 | Repetition: 9/15 | Clarity: 10/15
+  Tip: Add the error message for +15% accuracy
+
+$ reprompt distill --last 3 --summary
+  Session: feature-dev (42 turns, 18 important)
+  Key moments: initial spec → auth module → test failures → JWT fix → passing
+  Context: "Building auth system with JWT refresh tokens for Express API"
+
+$ reprompt compress "请帮我看一下这个代码，就是那个 login 的那个文件，好像有点问题"
+  Before: 31 tokens → After: 15 tokens (52% saved)
+  "看一下 login 文件的问题"
+```
+
+## What it does
+
+### Analyze
+
+| Command | Description |
+|---------|-------------|
+| `reprompt` | Instant dashboard -- prompts, sessions, avg score, top categories |
+| `reprompt scan` | Auto-discover prompts from 9 AI tools |
+| `reprompt score "prompt"` | Research-backed 0-100 scoring with 30+ features |
+| `reprompt compare "a" "b"` | Side-by-side prompt analysis (or `--best-worst` for auto-selection) |
+| `reprompt insights` | Personal patterns vs research-optimal benchmarks |
+| `reprompt style` | Prompting fingerprint with `--trends` for evolution tracking |
+| `reprompt agent` | Agent workflow analysis -- error loops, tool patterns, session efficiency |
+
+### Optimize
+
+| Command | Description |
+|---------|-------------|
+| `reprompt compress "prompt"` | 4-layer prompt compression (50%+ token savings typical) |
+| `reprompt distill` | Extract important turns from conversations with 6-signal scoring |
+| `reprompt distill --export` | Recover context when a session runs out -- paste into new session |
+| `reprompt lint` | Prompt quality linter with GitHub Action support |
+
+### Manage
+
+| Command | Description |
+|---------|-------------|
+| `reprompt privacy` | See what data you sent where -- file paths, errors, PII exposure |
+| `reprompt privacy --deep` | Scan for sensitive content: API keys, tokens, passwords, PII |
+| `reprompt report` | Full analytics: hot phrases, clusters, patterns (`--html` for dashboard) |
+| `reprompt digest` | Weekly summary comparing current vs previous period |
+| `reprompt wrapped` | Prompt DNA report -- persona, scores, shareable card |
+| `reprompt template save\|list\|use` | Save and reuse your best prompts |
+
+## Prompt Science
+
+Scoring is calibrated against 4 research papers covering 30+ features across 5 dimensions:
+
+| Dimension | What it measures | Paper |
+|-----------|-----------------|-------|
+| **Structure** | Markdown, code blocks, explicit constraints | Prompt Report 2406.06608 |
+| **Context** | File paths, error messages, technical specificity | Google 2512.14982 |
+| **Position** | Instruction placement relative to context | Stanford 2307.03172 |
+| **Repetition** | Redundancy that degrades model attention | Google 2512.14982 |
+| **Clarity** | Readability, sentence length, ambiguity | SPELL (EMNLP 2023) |
+
+All analysis runs locally in <1ms per prompt. No LLM calls, no network requests.
+
+## Conversation Distillation
+
+`reprompt distill` scores every turn in a conversation using 6 signals:
+
+- **Position** -- first/last turns carry framing and conclusions
+- **Length** -- substantial turns contain more information
+- **Tool trigger** -- turns that cause tool calls are action-driving
+- **Error recovery** -- turns that follow errors show problem-solving
+- **Semantic shift** -- topic changes mark conversation boundaries
+- **Uniqueness** -- novel phrasing vs repetitive follow-ups
+
+Session type (debugging, feature-dev, exploration, refactoring) is auto-detected and signal weights adapt accordingly.
+
+## Supported AI tools
+
+| Tool | Format | Auto-discovered by `scan` |
+|------|--------|--------------------------|
+| Claude Code | JSONL | Yes |
+| Codex CLI | JSONL | Yes |
+| Cursor | .vscdb | Yes |
+| Aider | Markdown | Yes |
+| Gemini CLI | JSON | Yes |
+| Cline (VS Code) | JSON | Yes |
+| OpenClaw / OpenCode | JSON | Yes |
+| ChatGPT | JSON | Via `reprompt import` |
+| Claude.ai | JSON/ZIP | Via `reprompt import` |
+
+## Installation
+
+```bash
+pip install reprompt-cli            # core (all features, zero config)
+pip install reprompt-cli[chinese]   # + Chinese prompt analysis (jieba)
+pip install reprompt-cli[mcp]       # + MCP server for Claude Code / Continue.dev / Zed
+```
+
+### Quick start
+
+```bash
+reprompt scan                       # discover prompts from installed AI tools
+reprompt                            # see your dashboard
+reprompt score "your prompt here"   # score any prompt instantly
+reprompt distill --last 1           # distill your most recent conversation
+```
+
+### Auto-scan after every session
+
+```bash
+reprompt install-hook               # adds post-session hook to Claude Code
+```
+
+### Browser extension
+
+Capture prompts from ChatGPT, Claude.ai, and Gemini directly in your browser:
+
+1. **Install the extension** from [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn)
+2. **Connect to the CLI:** `reprompt install-extension`
+3. **Verify:** `reprompt extension-status`
+
+Captured prompts sync locally via Native Messaging -- nothing leaves your machine.
+
+## Privacy
+
+- All analysis runs locally. No prompts leave your machine.
+- `reprompt privacy` shows exactly what you've sent to which AI tool.
+- Optional telemetry sends only anonymous 26-dimension feature vectors -- never prompt text.
+- Open source: audit exactly what's collected.
+
+[Privacy policy](https://getreprompt.dev/privacy)
+
+## Links
+
+- **Website:** [getreprompt.dev](https://getreprompt.dev)
+- **Chrome Extension:** [Chrome Web Store](https://chromewebstore.google.com/detail/reprompt/ojdccpagaanchmkninlbgbgemdcjckhn)
+- **PyPI:** [reprompt-cli](https://pypi.org/project/reprompt-cli/)
+- **Changelog:** [CHANGELOG.md](CHANGELOG.md)
+- **Privacy:** [getreprompt.dev/privacy](https://getreprompt.dev/privacy)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

{reprompt_cli-1.4.1 → reprompt_cli-1.6.0}/docs/roadmap.md

@@ -1,6 +1,6 @@
 # reprompt Roadmap
 
-> Last updated: 2026-03-25 · Current version: v1.4.1
+> Last updated: 2026-03-25 · Current version: v1.5.0
 
 ## Vision
 
@@ -10,18 +10,19 @@ reprompt is the **prompt intelligence** tool for AI sessions — distill your co
 
 ---
 
-## Current State (v1.4.0) — Production Stable
+## Current State (v1.5.0) — Production Stable
 
 ### Adapters (8)
 Claude Code · OpenClaw · Cursor IDE · Aider · Gemini CLI · Cline · ChatGPT · Claude.ai
 
-### Commands (23 visible, 5 deprecated)
-`scan` · `import` · `report` · `library` · `trends` · `recommend` · `template [save|list|use]` · `lint` · `search` · `demo` · `status` · `purge` · `install-hook` · `install-extension` · `extension-status` · `score` · `compare` · `insights` · `digest` · `style` · `wrapped` · `telemetry` · `mcp-serve` · `compress` · `distill` · `privacy`
+### Commands (23 visible, 8 deprecated)
+`scan` · `import` · `report` · `template [save|list|use]` · `lint` · `search` · `demo` · `status` · `purge` · `install-hook` · `install-extension` · `extension-status` · `score` · `compare` · `insights` · `digest` · `style` · `wrapped` · `telemetry` · `mcp-serve` · `compress` · `distill` · `privacy`
 
 ### Integrations
 - MCP server (`reprompt mcp-serve`) for IDE integration
 - GitHub Action (`action.yml`) for CI prompt quality checks
 - HTML dashboard (`reprompt report --html`)
+- Bare `reprompt` dashboard (zero-state + data-state)
 - Browser extension (Chrome/Firefox) via Native Messaging bridge
 - JSON output on all commands for pipeline integration
 
@@ -36,15 +37,30 @@ Claude Code · OpenClaw · Cursor IDE · Aider · Gemini CLI · Cline · ChatGPT
 | v1.3.1 | UX polish | Actionable suggestions on 5 commands, `--source` filter on all data commands |
 | v1.4.0 | Context recovery + consolidation | `distill --export` context document, signal transparency, command consolidation (27→23) |
 | v1.4.1 | Compare + style polish | `compare --best-worst` auto-pick, `style --trends` period-over-period deltas |
+| v1.5.0 | Dashboard + signal fixes | Bare `reprompt` dashboard, session type detection, distill signal quality fixes, scan hook shows once |
 
 ### Quality
-- 1316 tests, ≥90% coverage
+- 1397 tests, ≥90% coverage
 - Strict mypy, ruff lint/format
 - CI: coverage gate + pre-publish test step
 - Stable public API (`score_prompt`, `compare_prompts`, `extract_features`)
 
 ---
 
+## v1.5.0 — Dashboard + Session Type Detection + Signal Fixes
+
+| Priority | Item | Rationale |
+|----------|------|-----------|
+| P1 | Bare `reprompt` dashboard | **DONE** — zero-state shows onboarding guide; data-state shows 7d summary (prompts, sessions, avg score, compressibility, long sessions) with score-by-task-type breakdown and contextual next-step suggestions |
+| P1 | Session type detection | **DONE** — auto-detects session type (debug, feature, refactor, explore, review, etc.) and adjusts distill signal weights per type |
+| P2 | Distill signal quality fixes | **DONE** — position signal no longer over-scores small-talk openers/closers; length signal penalizes error dumps; error_recovery signal filters "ok try again" noise |
+| P3 | Scan hook suggestion shows once | **DONE** — `install-hook` suggestion displays only on first scan, not every time |
+| P3 | `library`/`recommend`/`trends` deprecated | **DONE** — consolidated into `template list`, `template list --smart`, and `digest --trends` respectively |
+
+**Status: Dashboard, session-aware distill, and signal quality shipped.**
+
+---
+
 ## v1.4 — Context Recovery + Command Consolidation
 
 | Priority | Item | Rationale |
@@ -61,11 +77,10 @@ Claude Code · OpenClaw · Cursor IDE · Aider · Gemini CLI · Cline · ChatGPT
 
 ---
 
-## v1.5+ — Future Work
+## v1.6+ — Future Work
 
 | Feature | Description |
 |---------|-------------|
-| Distill false positive reduction | Position signal breaks on small-talk openers / "thanks bye" closers; long error dumps score high on length+uniqueness but aren't decision points; "ok try again" triggers error_recovery but is noise. Community feedback from r/LLMDevs. |
 | Sensitive content detection | Privacy narrative; PII in prompts |
 | Agent workflow analysis | Multi-step agent session patterns |
 | `.reprompt.yml` configurable lint | Team/Pro direction |