reprompt-cli 0.1.1__tar.gz

reprompt_cli-0.1.1/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{js,ts,jsx,tsx,json,yaml,yml,css,html,svelte}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

reprompt_cli-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,29 @@
+name: Bug Report
+description: Report a bug in reprompt
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this?
+  - type: input
+    id: version
+    attributes:
+      label: reprompt version
+      description: "Output of `reprompt --version` (if available)"
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+  - type: input
+    id: os
+    attributes:
+      label: Operating system

reprompt_cli-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,39 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement!
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+      placeholder: "I'm always frustrated when..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any other approaches you've thought about?
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      options:
+        - CLI
+        - Adapters (Claude Code, OpenClaw, etc.)
+        - Dedup Engine
+        - Analyzer / Library
+        - Output / Reports
+        - Other

reprompt_cli-0.1.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Changes
+
+<!-- List the key changes -->
+
+## Testing
+
+- [ ] Tests added/updated
+- [ ] All tests pass (`uv run pytest tests/ -v`)
+- [ ] Lint passes (`ruff check src/ tests/`)

reprompt_cli-0.1.1/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "ci"

reprompt_cli-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+      - name: Lint
+        run: ruff check src/ tests/
+      - name: Format check
+        run: ruff format --check src/ tests/
+      - name: Test
+        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
+        with:
+          file: coverage.xml

reprompt_cli-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: pip install build
+      - name: Build
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

reprompt_cli-0.1.1/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project
+*.db
+.env

reprompt_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [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
+
+### 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.1.1/CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# Contributing to reprompt
+
+## 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
+
+## Adding Adapters
+
+To add support for a new AI coding tool:
+
+1. Create `src/reprompt/adapters/your_tool.py`
+2. Subclass `BaseAdapter`
+3. Implement `parse_session()` and `detect_installed()`
+4. Add test fixtures in `tests/fixtures/`
+5. Add tests in `tests/test_adapter_your_tool.py`
+
+## Architecture
+
+```
+src/reprompt/
+├── cli.py              # Typer CLI entry point
+├── config.py           # pydantic-settings configuration
+├── core/               # Business logic
+│   ├── models.py       # Prompt dataclass
+│   ├── dedup.py        # Two-layer deduplication
+│   ├── analyzer.py     # TF-IDF + K-means
+│   ├── library.py      # Pattern extraction
+│   └── pipeline.py     # Orchestrator
+├── adapters/           # AI tool parsers
+├── embeddings/         # Pluggable backends
+├── storage/            # SQLite layer
+└── output/             # Report formatters
+```

reprompt_cli-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 reprompt-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reprompt_cli-0.1.1/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: reprompt-cli
+Version: 0.1.1
+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
+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 :: 3 - Alpha
+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: 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: ollama
+Requires-Dist: requests>=2.31; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# reprompt
+
+[![CI](https://github.com/reprompt-dev/reprompt/actions/workflows/ci.yml/badge.svg)](https://github.com/reprompt-dev/reprompt/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python](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)
+
+> Discover, analyze, and evolve your best prompts from AI coding sessions.
+
+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
+
+```bash
+pipx install reprompt-cli
+reprompt scan
+reprompt report
+reprompt library
+```
+
+## Features
+
+- **Auto-detection** -- finds Claude Code and OpenClaw sessions automatically
+- **Two-layer dedup** -- SHA-256 exact + TF-IDF semantic similarity
+- **Hot terms analysis** -- TF-IDF discovers your most-used technical terms
+- **K-means clustering** -- groups similar prompts into themes
+- **Prompt library** -- extracts high-frequency patterns, auto-categorizes (debug/implement/test/review/refactor/explain/config)
+- **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
+- **Zero config** -- works out of the box, customize via env vars or TOML
+
+## Supported AI Tools
+
+| Tool | Status | Session Path |
+|------|--------|-------------|
+| Claude Code | Supported | `~/.claude/projects/` |
+| OpenClaw / OpenCode | Supported | `~/.opencode/sessions/` |
+| Cursor | Planned | -- |
+| Codex CLI | Planned | -- |
+| Gemini CLI | Planned | -- |
+
+## Usage
+
+```bash
+# Scan all detected AI tools
+reprompt scan
+
+# Scan specific source
+reprompt scan --source claude-code
+
+# Scan custom path
+reprompt scan --path ~/custom/sessions
+
+# Rich terminal report
+reprompt report
+
+# JSON output (for CI/pipelines)
+reprompt report --format json
+
+# View your prompt library
+reprompt library
+
+# Filter by category
+reprompt library --category debug
+
+# Export prompt library as Markdown
+reprompt library prompts.md
+
+# Database stats
+reprompt status
+
+# Auto-scan after sessions
+reprompt install-hook
+
+# Cleanup old data
+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:
+
+```bash
+# Environment variables (prefix: REPROMPT_)
+REPROMPT_EMBEDDING_BACKEND=ollama reprompt scan
+REPROMPT_DB_PATH=~/custom/reprompt.db reprompt status
+```
+
+```toml
+# ~/.config/reprompt/config.toml
+[embedding]
+backend = "tfidf"  # tfidf | ollama | local | openai
+
+[storage]
+db_path = "~/.local/share/reprompt/reprompt.db"
+
+[dedup]
+semantic_threshold = 0.85
+
+[library]
+min_frequency = 3
+```
+
+## Optional Backends
+
+```bash
+pip install reprompt-cli[ollama]   # Ollama API embeddings
+pip install reprompt-cli[local]    # sentence-transformers (CPU)
+pip install reprompt-cli[openai]   # OpenAI API embeddings
+```
+
+## Adding an Adapter
+
+Create a new adapter by subclassing `BaseAdapter`:
+
+```python
+from reprompt.adapters.base import BaseAdapter
+from reprompt.core.models import Prompt
+
+class MyToolAdapter(BaseAdapter):
+    name = "my-tool"
+    default_session_path = "~/.my-tool/sessions"
+
+    def parse_session(self, path):
+        # Parse session file -> list[Prompt]
+        ...
+
+    def detect_installed(self):
+        return Path(self.default_session_path).expanduser().exists()
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

reprompt_cli-0.1.1/README.md

@@ -0,0 +1,158 @@
+# reprompt
+
+[![CI](https://github.com/reprompt-dev/reprompt/actions/workflows/ci.yml/badge.svg)](https://github.com/reprompt-dev/reprompt/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/reprompt-cli)](https://pypi.org/project/reprompt-cli/)
+[![Python](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)
+
+> Discover, analyze, and evolve your best prompts from AI coding sessions.
+
+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
+
+```bash
+pipx install reprompt-cli
+reprompt scan
+reprompt report
+reprompt library
+```
+
+## Features
+
+- **Auto-detection** -- finds Claude Code and OpenClaw sessions automatically
+- **Two-layer dedup** -- SHA-256 exact + TF-IDF semantic similarity
+- **Hot terms analysis** -- TF-IDF discovers your most-used technical terms
+- **K-means clustering** -- groups similar prompts into themes
+- **Prompt library** -- extracts high-frequency patterns, auto-categorizes (debug/implement/test/review/refactor/explain/config)
+- **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
+- **Zero config** -- works out of the box, customize via env vars or TOML
+
+## Supported AI Tools
+
+| Tool | Status | Session Path |
+|------|--------|-------------|
+| Claude Code | Supported | `~/.claude/projects/` |
+| OpenClaw / OpenCode | Supported | `~/.opencode/sessions/` |
+| Cursor | Planned | -- |
+| Codex CLI | Planned | -- |
+| Gemini CLI | Planned | -- |
+
+## Usage
+
+```bash
+# Scan all detected AI tools
+reprompt scan
+
+# Scan specific source
+reprompt scan --source claude-code
+
+# Scan custom path
+reprompt scan --path ~/custom/sessions
+
+# Rich terminal report
+reprompt report
+
+# JSON output (for CI/pipelines)
+reprompt report --format json
+
+# View your prompt library
+reprompt library
+
+# Filter by category
+reprompt library --category debug
+
+# Export prompt library as Markdown
+reprompt library prompts.md
+
+# Database stats
+reprompt status
+
+# Auto-scan after sessions
+reprompt install-hook
+
+# Cleanup old data
+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:
+
+```bash
+# Environment variables (prefix: REPROMPT_)
+REPROMPT_EMBEDDING_BACKEND=ollama reprompt scan
+REPROMPT_DB_PATH=~/custom/reprompt.db reprompt status
+```
+
+```toml
+# ~/.config/reprompt/config.toml
+[embedding]
+backend = "tfidf"  # tfidf | ollama | local | openai
+
+[storage]
+db_path = "~/.local/share/reprompt/reprompt.db"
+
+[dedup]
+semantic_threshold = 0.85
+
+[library]
+min_frequency = 3
+```
+
+## Optional Backends
+
+```bash
+pip install reprompt-cli[ollama]   # Ollama API embeddings
+pip install reprompt-cli[local]    # sentence-transformers (CPU)
+pip install reprompt-cli[openai]   # OpenAI API embeddings
+```
+
+## Adding an Adapter
+
+Create a new adapter by subclassing `BaseAdapter`:
+
+```python
+from reprompt.adapters.base import BaseAdapter
+from reprompt.core.models import Prompt
+
+class MyToolAdapter(BaseAdapter):
+    name = "my-tool"
+    default_session_path = "~/.my-tool/sessions"
+
+    def parse_session(self, path):
+        # Parse session file -> list[Prompt]
+        ...
+
+    def detect_installed(self):
+        return Path(self.default_session_path).expanduser().exists()
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT