reprompt-cli 0.1.1__tar.gz → 0.3.0__tar.gz

{reprompt_cli-0.1.1 → reprompt_cli-0.3.0}/.github/workflows/ci.yml

@@ -14,13 +14,13 @@ jobs:
         os: [ubuntu-latest, macos-latest]
         python-version: ["3.10", "3.11", "3.12"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v7
       - name: Install dependencies
         run: uv pip install --system -e ".[dev]"
       - name: Lint
@@ -31,6 +31,6 @@ jobs:
         run: pytest tests/ -v --cov=reprompt --cov-report=xml
       - name: Upload coverage
         if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           file: coverage.xml

{reprompt_cli-0.1.1 → reprompt_cli-0.3.0}/.github/workflows/publish.yml

@@ -11,8 +11,8 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.12"
       - name: Install build tools

reprompt_cli-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

reprompt_cli-0.3.0/CHANGELOG.md

@@ -0,0 +1,74 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.0] - 2026-03-11
+
+### Added
+- `reprompt trends` — prompt evolution tracking with specificity scoring, delta arrows, insights
+- `reprompt effectiveness` — session quality scoring (clean exit, error ratio, duration heuristics)
+- Session metadata extraction during scan (tool calls, errors, duration, final status)
+- Hot Phrases: TF-IDF now extracts bigram/trigram phrases instead of single words
+- Prompt snapshots table for time-series trend data
+- IDE prefix stripping (`<ide_opened_file>`, `<ide_selection>`) — preserves real user questions
+- Compact/continuation message filtering (blocks session compaction noise)
+- Troubleshooting FAQ in README (Anaconda NumPy conflict)
+
+### Changed
+- "Hot Terms" → "Hot Phrases" in terminal report (n-gram based, stopwords filtered)
+- Tests: 176 → 246
+
+## [0.2.0] - 2026-03-11
+
+### Added
+- `reprompt search <query>` command for keyword search across prompt history
+- Local embedding backend (`pip install reprompt-cli[local]`, sentence-transformers)
+- OpenAI embedding backend (`pip install reprompt-cli[openai]`)
+- TOML config file support (`~/.config/reprompt/config.toml`)
+- K-means clustering output in terminal report
+- TF-IDF hot terms table in terminal report
+- OpenClaw adapter supports new `~/.openclaw/` path (backward compatible)
+- Competitive comparison table in README
+
+### Fixed
+- `install-hook` now registers in Claude Code `settings.json` (was writing unregistered shell script)
+- `ollama_url` config setting now propagates to OllamaEmbedder
+- Pattern IDs are stable across report runs (upsert instead of clear+re-insert)
+- Text truncation in all outputs now shows `...` suffix
+- JSON output uses `print()` instead of Rich `console.print()` to avoid markup corruption
+
+### Changed
+- Tests: 118 → 176
+- OpenClaw adapter checks both `~/.openclaw/` (new) and `~/.opencode/` (legacy)
+
+## [0.1.1] - 2026-03-10
+
+### Fixed
+- Prevent connection leak in all database methods (try/finally)
+- Fix session marking for incremental scan accuracy
+- Fix purge validation for date format parsing
+- Fix pattern dedup to avoid duplicate entries
+- Improve Ollama error messages when server is unreachable
+- Fix JSON output (`--format json`) producing invalid escape sequences
+
+### Added
+- `--version` / `-V` flag to CLI
+- mypy strict mode compliance
+
+## [0.1.0] - 2026-03-10
+
+### Added
+
+- Initial release
+- Claude Code session adapter (JSONL format)
+- OpenClaw session adapter
+- Two-layer deduplication (SHA-256 exact + TF-IDF semantic)
+- TF-IDF hot terms analysis
+- K-means prompt clustering
+- Prompt pattern library with auto-categorization
+- Rich terminal reports with tables and bar charts
+- JSON output for CI/pipeline integration
+- Markdown export for prompt library
+- `install-hook` command for Claude Code automation
+- Ollama embedding backend (optional)
+- Zero-config defaults with env var and TOML override

reprompt_cli-0.3.0/CLAUDE.md

@@ -0,0 +1,67 @@
+# reprompt
+
+CLI tool that extracts, deduplicates, and analyzes prompts from AI coding sessions.
+
+## Build & Test
+
+```bash
+uv venv && uv pip install -e ".[dev]"
+uv run pytest tests/ -v                    # run tests
+uv run pytest tests/ -v --cov=reprompt     # with coverage
+uv run ruff check src/ tests/              # lint
+uv run ruff format src/ tests/             # format
+uv run mypy src/reprompt/                  # type check (strict)
+uv run python -m build                     # build wheel
+```
+
+## Architecture
+
+```
+src/reprompt/
+├── cli.py              # Typer CLI (scan, report, search, library, status, purge, install-hook)
+├── config.py           # pydantic-settings, env vars (REPROMPT_ prefix) + TOML config
+├── core/
+│   ├── models.py       # Prompt dataclass (auto SHA-256 hash)
+│   ├── dedup.py        # Two-layer dedup: exact hash + TF-IDF cosine
+│   ├── analyzer.py     # TF-IDF hot terms + K-means clustering
+│   ├── library.py      # Pattern extraction + keyword categorization
+│   └── pipeline.py     # Orchestrator: scan → dedup → store → analyze → cluster
+├── adapters/
+│   ├── base.py         # BaseAdapter ABC
+│   ├── claude_code.py  # Claude Code JSONL parser
+│   └── openclaw.py     # OpenClaw JSON parser (supports ~/.openclaw/ + legacy ~/.opencode/)
+├── embeddings/
+│   ├── base.py         # BaseEmbedder ABC
+│   ├── tfidf.py        # Default (sklearn, zero config)
+│   ├── ollama.py       # Optional: pip install reprompt-cli[ollama]
+│   ├── local_embed.py  # Optional: pip install reprompt-cli[local] (sentence-transformers)
+│   └── openai_embed.py # Optional: pip install reprompt-cli[openai]
+├── storage/
+│   └── db.py           # SQLite: prompts, processed_sessions, prompt_patterns, term_stats
+└── output/
+    ├── terminal.py     # Rich tables + bar charts + hot terms + clusters
+    ├── json_out.py     # JSON for pipelines
+    └── markdown.py     # Markdown export
+```
+
+## Data Flow
+
+```
+Session files → Adapter.parse() → list[Prompt]
+  → DedupEngine: SHA-256 exact → TF-IDF cosine similarity
+  → SQLite: insert unique prompts, mark dupes
+  → Analyzer: TF-IDF hot terms + K-means clusters
+  → Library: extract high-frequency patterns, auto-categorize
+  → Output: terminal / JSON / Markdown
+```
+
+## Key Conventions
+
+- Package name: `reprompt-cli` (PyPI), CLI command: `reprompt`
+- Python >=3.10, type hints required, mypy strict
+- ruff for lint + format (line-length=100)
+- All db methods use try/finally for conn.close()
+- 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, 176 tests, 95% coverage target

reprompt_cli-0.3.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Code of Conduct
+
+This project follows the [Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+We are committed to providing a welcoming and inclusive experience for everyone.
+
+## Reporting
+
+If you experience or witness unacceptable behavior, please report it by opening a [GitHub issue](https://github.com/reprompt-dev/reprompt/issues) or contacting the maintainers directly.
+
+Reports will be reviewed and addressed promptly.

{reprompt_cli-0.1.1 → reprompt_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reprompt-cli
-Version: 0.1.1
+Version: 0.3.0
 Summary: Discover, analyze, and evolve your best prompts from AI coding sessions
 Project-URL: Homepage, https://github.com/reprompt-dev/reprompt
 Project-URL: Repository, https://github.com/reprompt-dev/reprompt
@@ -47,6 +47,8 @@ Description-Content-Type: text/markdown
 
 > Discover, analyze, and evolve your best prompts from AI coding sessions.
 
+*repomix packs your code for AI. reprompt extracts insights from AI.*
+
 Every developer's AI session history contains reusable prompt patterns -- scattered across hundreds of session files. **reprompt** extracts them, deduplicates, analyzes frequency, and builds a personal prompt library that evolves over time.
 
 ## Quick Start
@@ -58,6 +60,25 @@ reprompt report
 reprompt library
 ```
 
+## Terminal Report
+
+```
+reprompt -- AI Session Analytics
+========================================
+
+ Overview
+ Total prompts:        1,247
+ Unique (deduped):       832
+ Sessions scanned:       156
+ Sources: claude-code, openclaw
+
+ Top Prompt Patterns
+ #  | Pattern                  | Count | Category
+ 1  | fix the failing test...  |    42 | debug
+ 2  | add unit tests for...    |    38 | test
+ 3  | refactor X to use...     |    27 | refactor
+```
+
 ## Features
 
 - **Auto-detection** -- finds Claude Code and OpenClaw sessions automatically
@@ -68,17 +89,36 @@ reprompt library
 - **Rich reports** -- beautiful terminal output with tables and bar charts
 - **Multiple formats** -- terminal, JSON (for pipelines), Markdown (for docs)
 - **Pluggable adapters** -- add support for any AI coding tool
+- **Prompt search** -- find past prompts by keyword across all sessions
 - **Zero config** -- works out of the box, customize via env vars or TOML
 
+## How reprompt Compares
+
+| Feature | reprompt | prompt-manager | agent-sessions | cclog |
+|---------|----------|---------------|----------------|-------|
+| Multi-tool support | ✅ Claude, OpenClaw, + adapters | ✅ Multiple | ✅ Multiple | ❌ Claude only |
+| Exact dedup (SHA-256) | ✅ | ❌ | ❌ | ❌ |
+| Semantic dedup (TF-IDF) | ✅ | ❌ | ❌ | ❌ |
+| Hot terms analysis | ✅ TF-IDF | ❌ | ❌ | ❌ |
+| K-means clustering | ✅ | ❌ | ❌ | ❌ |
+| Pattern library | ✅ Auto-categorized | ❌ | ❌ | ❌ |
+| CLI interface | ✅ | ✅ TUI | ❌ macOS app | ✅ |
+| JSON/Markdown export | ✅ | ❌ | ❌ | ❌ |
+| Pluggable adapters | ✅ | ✅ | ❌ | ❌ |
+| Zero config | ✅ | ✅ | ✅ | ✅ |
+
 ## Supported AI Tools
 
 | Tool | Status | Session Path |
 |------|--------|-------------|
 | Claude Code | Supported | `~/.claude/projects/` |
-| OpenClaw / OpenCode | Supported | `~/.opencode/sessions/` |
+| OpenClaw / OpenCode | Supported | `~/.openclaw/` + `~/.opencode/sessions/` |
+| Codex CLI | Planned (v0.4) | `~/.codex/` |
+| Aider | Planned | `~/.aider/` |
+| Gemini CLI | Planned | `~/.gemini/` |
+| Continue.dev | Via MCP | MCP protocol |
+| Zed | Via MCP | MCP protocol |
 | Cursor | Planned | -- |
-| Codex CLI | Planned | -- |
-| Gemini CLI | Planned | -- |
 
 ## Usage
 
@@ -98,6 +138,10 @@ reprompt report
 # JSON output (for CI/pipelines)
 reprompt report --format json
 
+# Search your prompt history
+reprompt search "authentication"
+reprompt search "debug" --limit 5
+
 # View your prompt library
 reprompt library
 
@@ -117,25 +161,6 @@ reprompt install-hook
 reprompt purge --older-than 90d
 ```
 
-## Terminal Report
-
-```
-reprompt -- AI Session Analytics
-========================================
-
- Overview
- Total prompts:        1,247
- Unique (deduped):       832
- Sessions scanned:       156
- Sources: claude-code, openclaw
-
- Top Prompt Patterns
- #  | Pattern                  | Count | Category
- 1  | fix the failing test...  |    42 | debug
- 2  | add unit tests for...    |    38 | test
- 3  | refactor X to use...     |    27 | refactor
-```
-
 ## Configuration
 
 Zero config by default. Customize with environment variables or TOML:
@@ -189,6 +214,27 @@ class MyToolAdapter(BaseAdapter):
         return Path(self.default_session_path).expanduser().exists()
 ```
 
+## Troubleshooting
+
+### NumPy conflict in Anaconda environments
+
+If you see an error like:
+```
+A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x
+```
+
+This happens when Anaconda's base environment has packages compiled against NumPy 1.x but a newer NumPy 2.x is installed. **This is not a reprompt bug** — it's an environment conflict.
+
+**Fix:** Install reprompt in an isolated environment using pipx:
+
+```bash
+pip3 install --user pipx
+pipx install reprompt-cli
+reprompt scan
+```
+
+pipx creates a dedicated virtualenv for reprompt, avoiding conflicts with your system Python or Anaconda.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

{reprompt_cli-0.1.1 → reprompt_cli-0.3.0}/README.md

@@ -7,6 +7,8 @@
 
 > Discover, analyze, and evolve your best prompts from AI coding sessions.
 
+*repomix packs your code for AI. reprompt extracts insights from AI.*
+
 Every developer's AI session history contains reusable prompt patterns -- scattered across hundreds of session files. **reprompt** extracts them, deduplicates, analyzes frequency, and builds a personal prompt library that evolves over time.
 
 ## Quick Start
@@ -18,6 +20,25 @@ reprompt report
 reprompt library
 ```
 
+## Terminal Report
+
+```
+reprompt -- AI Session Analytics
+========================================
+
+ Overview
+ Total prompts:        1,247
+ Unique (deduped):       832
+ Sessions scanned:       156
+ Sources: claude-code, openclaw
+
+ Top Prompt Patterns
+ #  | Pattern                  | Count | Category
+ 1  | fix the failing test...  |    42 | debug
+ 2  | add unit tests for...    |    38 | test
+ 3  | refactor X to use...     |    27 | refactor
+```
+
 ## Features
 
 - **Auto-detection** -- finds Claude Code and OpenClaw sessions automatically
@@ -28,17 +49,36 @@ reprompt library
 - **Rich reports** -- beautiful terminal output with tables and bar charts
 - **Multiple formats** -- terminal, JSON (for pipelines), Markdown (for docs)
 - **Pluggable adapters** -- add support for any AI coding tool
+- **Prompt search** -- find past prompts by keyword across all sessions
 - **Zero config** -- works out of the box, customize via env vars or TOML
 
+## How reprompt Compares
+
+| Feature | reprompt | prompt-manager | agent-sessions | cclog |
+|---------|----------|---------------|----------------|-------|
+| Multi-tool support | ✅ Claude, OpenClaw, + adapters | ✅ Multiple | ✅ Multiple | ❌ Claude only |
+| Exact dedup (SHA-256) | ✅ | ❌ | ❌ | ❌ |
+| Semantic dedup (TF-IDF) | ✅ | ❌ | ❌ | ❌ |
+| Hot terms analysis | ✅ TF-IDF | ❌ | ❌ | ❌ |
+| K-means clustering | ✅ | ❌ | ❌ | ❌ |
+| Pattern library | ✅ Auto-categorized | ❌ | ❌ | ❌ |
+| CLI interface | ✅ | ✅ TUI | ❌ macOS app | ✅ |
+| JSON/Markdown export | ✅ | ❌ | ❌ | ❌ |
+| Pluggable adapters | ✅ | ✅ | ❌ | ❌ |
+| Zero config | ✅ | ✅ | ✅ | ✅ |
+
 ## Supported AI Tools
 
 | Tool | Status | Session Path |
 |------|--------|-------------|
 | Claude Code | Supported | `~/.claude/projects/` |
-| OpenClaw / OpenCode | Supported | `~/.opencode/sessions/` |
+| OpenClaw / OpenCode | Supported | `~/.openclaw/` + `~/.opencode/sessions/` |
+| Codex CLI | Planned (v0.4) | `~/.codex/` |
+| Aider | Planned | `~/.aider/` |
+| Gemini CLI | Planned | `~/.gemini/` |
+| Continue.dev | Via MCP | MCP protocol |
+| Zed | Via MCP | MCP protocol |
 | Cursor | Planned | -- |
-| Codex CLI | Planned | -- |
-| Gemini CLI | Planned | -- |
 
 ## Usage
 
@@ -58,6 +98,10 @@ reprompt report
 # JSON output (for CI/pipelines)
 reprompt report --format json
 
+# Search your prompt history
+reprompt search "authentication"
+reprompt search "debug" --limit 5
+
 # View your prompt library
 reprompt library
 
@@ -77,25 +121,6 @@ reprompt install-hook
 reprompt purge --older-than 90d
 ```
 
-## Terminal Report
-
-```
-reprompt -- AI Session Analytics
-========================================
-
- Overview
- Total prompts:        1,247
- Unique (deduped):       832
- Sessions scanned:       156
- Sources: claude-code, openclaw
-
- Top Prompt Patterns
- #  | Pattern                  | Count | Category
- 1  | fix the failing test...  |    42 | debug
- 2  | add unit tests for...    |    38 | test
- 3  | refactor X to use...     |    27 | refactor
-```
-
 ## Configuration
 
 Zero config by default. Customize with environment variables or TOML:
@@ -149,6 +174,27 @@ class MyToolAdapter(BaseAdapter):
         return Path(self.default_session_path).expanduser().exists()
 ```
 
+## Troubleshooting
+
+### NumPy conflict in Anaconda environments
+
+If you see an error like:
+```
+A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x
+```
+
+This happens when Anaconda's base environment has packages compiled against NumPy 1.x but a newer NumPy 2.x is installed. **This is not a reprompt bug** — it's an environment conflict.
+
+**Fix:** Install reprompt in an isolated environment using pipx:
+
+```bash
+pip3 install --user pipx
+pipx install reprompt-cli
+reprompt scan
+```
+
+pipx creates a dedicated virtualenv for reprompt, avoiding conflicts with your system Python or Anaconda.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

reprompt_cli-0.3.0/docs/launch-post.md

@@ -0,0 +1,106 @@
+# Launch Post Draft
+
+Target: Hacker News (Show HN), Reddit (r/programming, r/MachineLearning), Twitter/X
+
+---
+
+## Show HN: reprompt -- Discover and reuse your best prompts from AI coding sessions
+
+Every developer using AI coding tools has hundreds of session files scattered across their system. Buried in those sessions are the prompts that actually worked -- the ones that led to clean implementations, successful debugging, and productive refactoring.
+
+**reprompt** is a CLI tool that extracts prompts from your AI coding session history, deduplicates them (exact + semantic), analyzes frequency patterns, and builds a personal prompt library that evolves over time.
+
+### What it does
+
+- Scans Claude Code and OpenClaw/OpenCode sessions automatically
+- Two-layer dedup: SHA-256 for exact matches, TF-IDF cosine similarity for semantic near-duplicates
+- Discovers your "hot terms" via TF-IDF analysis
+- K-means clustering groups similar prompts into themes
+- Auto-categorizes patterns: debug, implement, test, review, refactor, explain, config
+- Exports as terminal report, JSON (for pipelines), or Markdown
+
+### Quick start
+
+```bash
+pipx install reprompt-cli
+reprompt scan          # finds sessions automatically
+reprompt report        # see your patterns
+reprompt library       # browse your prompt library
+```
+
+### Why I built this
+
+After 6+ months of daily AI-assisted coding, I realized I was re-inventing prompts constantly. The same debugging approach, the same "add tests for X" pattern, the same refactoring instructions -- typed fresh each time.
+
+Session files are write-once logs. They're not designed for retrieval. reprompt turns that dead data into a living library of your best practices.
+
+### Technical details
+
+- Python, MIT licensed, pip-installable
+- Zero external dependencies for core (scikit-learn for TF-IDF/clustering, Rich for terminal output)
+- Pluggable adapter pattern -- adding a new AI tool is ~30 lines
+- Optional embedding backends: Ollama, sentence-transformers, OpenAI
+- SQLite storage, zero config defaults
+
+GitHub: https://github.com/reprompt-dev/reprompt
+PyPI: https://pypi.org/project/reprompt-cli/
+
+---
+
+## Twitter/X version (thread)
+
+**Tweet 1:**
+I built reprompt -- a CLI that mines your AI coding sessions for reusable prompt patterns.
+
+After months of Claude Code, I realized my best prompts were buried in hundreds of JSONL files. Same patterns, retyped from scratch every time.
+
+`pipx install reprompt-cli`
+
+**Tweet 2:**
+How it works:
+1. Scans your Claude Code / OpenClaw sessions
+2. SHA-256 + TF-IDF dedup (exact + semantic)
+3. K-means clustering for theme discovery
+4. Auto-categorizes: debug, implement, test, review...
+5. Builds a prompt library that grows over time
+
+**Tweet 3:**
+Three commands to get started:
+
+```
+reprompt scan     # auto-detect sessions
+reprompt report   # see your patterns
+reprompt library  # browse & export
+```
+
+Zero config. MIT licensed. Adapter pattern makes adding new AI tools trivial (~30 lines).
+
+GitHub: https://github.com/reprompt-dev/reprompt
+
+---
+
+## Reddit r/programming version
+
+**Title:** reprompt: CLI tool to extract, deduplicate, and analyze prompts from your AI coding sessions
+
+**Body:**
+
+I've been using Claude Code daily for months and noticed I kept writing the same types of prompts over and over. My session history had hundreds of files with reusable patterns buried in them -- but no way to search or learn from them.
+
+So I built **reprompt**, a CLI that:
+
+- Auto-detects Claude Code and OpenClaw session files
+- Extracts user prompts and deduplicates them (SHA-256 exact + TF-IDF semantic)
+- Runs TF-IDF analysis to find your "hot terms"
+- Uses K-means clustering to group similar prompts
+- Auto-categorizes patterns into debug/implement/test/review/refactor/explain/config
+- Exports as rich terminal report, JSON, or Markdown
+
+It's designed to be extensible -- adding support for a new AI tool is just subclassing `BaseAdapter` and implementing `parse_session()`. Cursor and Codex CLI adapters are planned.
+
+Install: `pipx install reprompt-cli`
+
+- GitHub: https://github.com/reprompt-dev/reprompt
+- PyPI: https://pypi.org/project/reprompt-cli/
+- License: MIT
+- Python 3.10+