reprompt-cli 1.5.0__tar.gz → 1.7.1__tar.gz

{reprompt_cli-1.5.0 → reprompt_cli-1.7.1}/.gitignore

@@ -41,6 +41,7 @@ thoughts/
 .tldr/
 .tldrignore
 .worktrees/
+CLAUDE.md
 
 # Launch / marketing drafts (not part of the codebase)
 docs/launch/

reprompt_cli-1.7.1/.pre-commit-hooks.yaml

@@ -0,0 +1,26 @@
+- id: reprompt-lint
+  name: reprompt lint
+  description: Check AI prompt quality in session files
+  entry: reprompt lint
+  language: python
+  pass_filenames: false
+  always_run: true
+  additional_dependencies: ["reprompt-cli"]
+
+- id: reprompt-lint-strict
+  name: reprompt lint (strict)
+  description: Check AI prompt quality — fail on warnings too
+  entry: reprompt lint --strict
+  language: python
+  pass_filenames: false
+  always_run: true
+  additional_dependencies: ["reprompt-cli"]
+
+- id: reprompt-lint-score
+  name: reprompt lint (score gate)
+  description: Check AI prompt quality — fail if avg score below threshold
+  entry: reprompt lint --score-threshold 50
+  language: python
+  pass_filenames: false
+  always_run: true
+  additional_dependencies: ["reprompt-cli"]

{reprompt_cli-1.5.0 → reprompt_cli-1.7.1}/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.6.1] - 2026-03-28
+
+### Fixed
+- **Critical: `reprompt scan` crash** — `compute_pattern_effectiveness` failed on prompts containing SQL LIKE wildcards (`%`, `_`). Replaced `LIKE` with `INSTR()` for exact substring matching.
+- **Score calibration** — single-paragraph prompts incorrectly received 0/20 for Position (instruction was treated as "buried in the middle"). Now correctly scores instruction-at-start as optimal position.
+- **Compress grammar bugs** — fixed leading whitespace after filler deletion, dangling "that" after "the thing is" removal, orphaned commas, and remnant pleasantry fragments.
+- **Deprecated command references** — `reprompt library` and `reprompt trends` references in report footer and scan guidance now point to `reprompt template list` and `reprompt digest --trends`.
+- **Wrong adapter names** — `--source` help examples used non-existent `chatgpt-ext`; fixed to `chatgpt-export`.
+
+### Improved
+- **Compress engine** — added 15 filler phrases (`kind of`, `sort of`, `additionally`, `the fact that`, etc.) and 16 phrase simplification rules (`take a look at` → `check`, `let me know` → removed, etc.). Added post-compression cleanup pass for whitespace, punctuation, and sentence capitalization. Typical savings improved from 3-33% to 38-60%.
+- **Score UX** — suggestions now sorted by impact (high first); paper citations dimmed; new "Very Poor" grade tier for scores under 20.
+- **CLI help** — added usage examples to 7 key commands (score, scan, compress, compare, distill, lint, privacy). Added Quick Start guide to main `--help`. Standardized `--source` option across all commands with `-s` shorthand.
+- **Help panels** — moved `digest` from Manage to Analyze panel. Listed all 9 adapters in `scan --help`.
+- Tests: 1490 → 1497
+
+## [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

reprompt_cli-1.7.1/CONTRIBUTING.md

@@ -0,0 +1,120 @@
+# Contributing to reprompt
+
+Thanks for your interest in contributing! reprompt is an open-source prompt intelligence tool, and contributions of all kinds are welcome.
+
+## Quick Links
+
+- [Good First Issues](https://github.com/reprompt-dev/reprompt/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
+- [Help Wanted](https://github.com/reprompt-dev/reprompt/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
+
+## Development Setup
+
+```bash
+git clone https://github.com/reprompt-dev/reprompt
+cd reprompt
+uv venv
+uv pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+uv run pytest tests/ -v
+uv run pytest tests/ -v --cov=reprompt  # with coverage
+```
+
+## Code Style
+
+We use [ruff](https://docs.astral.sh/ruff/) for linting and formatting:
+
+```bash
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+```
+
+## Type Checking
+
+We use [mypy](https://mypy-lang.org/) in strict mode:
+
+```bash
+uv run mypy src/reprompt/
+```
+
+## Pull Requests
+
+1. Fork the repo and create a feature branch
+2. Write tests for new functionality
+3. Ensure all tests pass and coverage doesn't decrease
+4. Run `ruff check` and `ruff format`
+5. Run `mypy src/reprompt/` -- must pass clean
+6. Submit a PR with a clear description
+
+### Before Submitting
+
+- **Comment on the issue first** — introduce yourself and outline your approach before writing code. This avoids wasted work and duplicate effort.
+- **One PR per issue** — don't submit multiple PRs for the same issue.
+- PRs from brand-new GitHub accounts with no prior project engagement will generally not be reviewed.
+
+## Common Contribution Areas
+
+### Adding Adapters (new AI tool support)
+
+Adding a new adapter is the easiest way to contribute. Each adapter is ~50-100 lines:
+
+1. Create `src/reprompt/adapters/your_tool.py`
+2. Subclass `BaseAdapter` from `adapters/base.py`
+3. Implement:
+   - `name` property -- adapter identifier (e.g., `"copilot"`)
+   - `default_session_path` -- where the tool stores sessions
+   - `discover_sessions()` -- find session files
+   - `parse_session(path)` -- extract `Prompt` objects
+   - Optional: `parse_conversation(path)` -- extract full conversation turns
+4. Register in `core/pipeline.py` → `get_adapters()`
+5. Add tests in `tests/test_your_tool_adapter.py`
+
+**Reference adapters:**
+- `adapters/cline.py` -- simplest (~80 lines, JSON format)
+- `adapters/aider.py` -- markdown parsing
+- `adapters/cursor.py` -- SQLite/vscdb format
+
+### Adding Lint Rules
+
+Each lint rule is a standalone function in `core/lint.py`:
+
+1. Add your rule check in `lint_prompt()`
+2. Return a `LintViolation` with `severity="error"` or `"warning"`
+3. Add tests in `tests/test_lint.py`
+
+### Adding Privacy Patterns
+
+Extend sensitive content detection in `core/privacy_scan.py`:
+
+1. Add a regex pattern to the `PATTERNS` dict
+2. Add category mapping in `CATEGORY_MAP`
+3. Add safety filter if needed (to exclude false positives)
+4. Add tests in `tests/test_privacy_scan.py`
+
+## Architecture
+
+```
+src/reprompt/
+├── cli.py              # Typer CLI (21 commands)
+├── config.py           # pydantic-settings configuration
+├── core/               # Business logic
+│   ├── models.py       # Prompt dataclass
+│   ├── scorer.py       # Research-calibrated 0-100 scoring
+│   ├── lint.py         # Quality linter
+│   ├── compress.py     # 4-layer prompt compression
+│   ├── distill.py      # Conversation distillation
+│   ├── agent.py        # Agent workflow analysis
+│   ├── privacy_scan.py # Sensitive content detection
+│   └── pipeline.py     # Orchestrator
+├── adapters/           # 9 AI tool parsers
+├── storage/            # SQLite layer
+├── bridge/             # Browser extension Native Messaging
+└── output/             # Report formatters (terminal, JSON, HTML)
+```
+
+## Questions?
+
+Open an issue or start a discussion. We're happy to help you get started.

{reprompt_cli-1.5.0 → reprompt_cli-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reprompt-cli
-Version: 1.5.0
+Version: 1.7.1
 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
@@ -45,16 +45,18 @@ Description-Content-Type: text/markdown
 
 # `re:prompt`
 
-**Prompt Intelligence for AI power users** -- understand, optimize, and manage your AI conversations.
+**Analyze what you type into AI tools** -- prompt scoring, agent error loops, leaked credential detection, conversation distillation.
 
 [![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-1397-brightgreen)](https://github.com/reprompt-dev/reprompt)
+[![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)
 
 ---
 
+![reprompt demo](docs/demo.gif)
+
 ## See it in action
 
 ```bash
@@ -67,18 +69,18 @@ $ reprompt
   ╰────────────────────────────────────────────────────────────╯
 
 $ 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
+  Score: 40/100  (Fair)
+  Structure: 0/25 | Context: 8/25 | Position: 20/20 | Repetition: 0/15 | Clarity: 12/15
+  Tip: Include the error message -- debug prompts with errors are 3.7x more effective
 
 $ 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 文件的问题"
+$ reprompt compress "I was wondering if you could please help me refactor this code. Basically what I need is to split this function into smaller helpers and add error handling."
+  Before: 28 tokens → After: 14 tokens (50% saved)
+  "Help me refactor this code. Split this function into smaller helpers and add error handling."
 ```
 
 ## What it does
@@ -88,17 +90,18 @@ $ reprompt compress "请帮我看一下这个代码，就是那个 login 的那
 | Command | Description |
 |---------|-------------|
 | `reprompt` | Instant dashboard -- prompts, sessions, avg score, top categories |
-| `reprompt scan` | Auto-discover prompts from 8 AI tools |
+| `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 compress "prompt"` | 4-layer prompt compression (40-60% 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 |
@@ -108,6 +111,7 @@ $ reprompt compress "请帮我看一下这个代码，就是那个 login 的那
 | 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 |
@@ -145,6 +149,7 @@ Session type (debugging, feature-dev, exploration, refactoring) is auto-detected
 | Tool | Format | Auto-discovered by `scan` |
 |------|--------|--------------------------|
 | Claude Code | JSONL | Yes |
+| Codex CLI | JSONL | Yes |
 | Cursor | .vscdb | Yes |
 | Aider | Markdown | Yes |
 | Gemini CLI | JSON | Yes |
@@ -176,6 +181,48 @@ reprompt distill --last 1           # distill your most recent conversation
 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.
+
+### CI integration
+
+#### GitHub Action
+
+```yaml
+# .github/workflows/prompt-lint.yml
+- uses: reprompt-dev/reprompt@main
+  with:
+    score-threshold: 50   # fail if avg prompt score < 50
+    strict: true          # fail on warnings too
+    comment-on-pr: true   # post quality report as PR comment
+```
+
+#### pre-commit
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/reprompt-dev/reprompt
+    rev: v1.7.0
+    hooks:
+      - id: reprompt-lint
+```
+
+#### Direct CLI
+
+```bash
+reprompt lint --score-threshold 50  # exit 1 if avg score < 50
+reprompt lint --strict              # exit 1 on warnings
+reprompt lint --json                # machine-readable output
+```
+
 ## Privacy
 
 - All analysis runs locally. No prompts leave your machine.
@@ -188,6 +235,7 @@ reprompt install-hook               # adds post-session hook to Claude Code
 ## 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)

{reprompt_cli-1.5.0 → reprompt_cli-1.7.1}/README.md

@@ -1,15 +1,17 @@
 # `re:prompt`
 
-**Prompt Intelligence for AI power users** -- understand, optimize, and manage your AI conversations.
+**Analyze what you type into AI tools** -- prompt scoring, agent error loops, leaked credential detection, conversation distillation.
 
 [![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-1397-brightgreen)](https://github.com/reprompt-dev/reprompt)
+[![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)
 
 ---
 
+![reprompt demo](docs/demo.gif)
+
 ## See it in action
 
 ```bash
@@ -22,18 +24,18 @@ $ reprompt
   ╰────────────────────────────────────────────────────────────╯
 
 $ 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
+  Score: 40/100  (Fair)
+  Structure: 0/25 | Context: 8/25 | Position: 20/20 | Repetition: 0/15 | Clarity: 12/15
+  Tip: Include the error message -- debug prompts with errors are 3.7x more effective
 
 $ 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 文件的问题"
+$ reprompt compress "I was wondering if you could please help me refactor this code. Basically what I need is to split this function into smaller helpers and add error handling."
+  Before: 28 tokens → After: 14 tokens (50% saved)
+  "Help me refactor this code. Split this function into smaller helpers and add error handling."
 ```
 
 ## What it does
@@ -43,17 +45,18 @@ $ reprompt compress "请帮我看一下这个代码，就是那个 login 的那
 | Command | Description |
 |---------|-------------|
 | `reprompt` | Instant dashboard -- prompts, sessions, avg score, top categories |
-| `reprompt scan` | Auto-discover prompts from 8 AI tools |
+| `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 compress "prompt"` | 4-layer prompt compression (40-60% 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 |
@@ -63,6 +66,7 @@ $ reprompt compress "请帮我看一下这个代码，就是那个 login 的那
 | 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 |
@@ -100,6 +104,7 @@ Session type (debugging, feature-dev, exploration, refactoring) is auto-detected
 | Tool | Format | Auto-discovered by `scan` |
 |------|--------|--------------------------|
 | Claude Code | JSONL | Yes |
+| Codex CLI | JSONL | Yes |
 | Cursor | .vscdb | Yes |
 | Aider | Markdown | Yes |
 | Gemini CLI | JSON | Yes |
@@ -131,6 +136,48 @@ reprompt distill --last 1           # distill your most recent conversation
 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.
+
+### CI integration
+
+#### GitHub Action
+
+```yaml
+# .github/workflows/prompt-lint.yml
+- uses: reprompt-dev/reprompt@main
+  with:
+    score-threshold: 50   # fail if avg prompt score < 50
+    strict: true          # fail on warnings too
+    comment-on-pr: true   # post quality report as PR comment
+```
+
+#### pre-commit
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/reprompt-dev/reprompt
+    rev: v1.7.0
+    hooks:
+      - id: reprompt-lint
+```
+
+#### Direct CLI
+
+```bash
+reprompt lint --score-threshold 50  # exit 1 if avg score < 50
+reprompt lint --strict              # exit 1 on warnings
+reprompt lint --json                # machine-readable output
+```
+
 ## Privacy
 
 - All analysis runs locally. No prompts leave your machine.
@@ -143,6 +190,7 @@ reprompt install-hook               # adds post-session hook to Claude Code
 ## 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)