Propre CLI
Propre is a post-vibe-coding cleanup and hardening CLI.
It analyzes AI-generated or rapidly prototyped codebases and prepares them for real-world use by detecting structural issues, unsafe patterns, and production blockers — then optionally fixing them.
From messy prototype → production-ready project.
Installation
pip install propre-cli
Quick Start
Analyze a project:
propre scan .
Auto-fix safe issues:
propre fix .
Check production readiness:
propre ship .
Generate a report:
propre report . -o report.md
Commands
| Command | Description |
|---|---|
propre scan [path] |
Full analysis (no changes) |
propre fix [path] |
Auto-fix safe issues |
propre res [path] |
Project restructuring only |
propre sec [path] |
Secret scanning only |
propre ship [path] |
Production readiness checklist |
propre report [path] -o file |
Export full report |
Common Workflows
Before committing AI-generated code
propre scan .
Before opening a pull request
propre fix .
propre ship .
CI safety check
propre scan . --ci
Security audit
propre sec . --deep-scan
Global Flags
| Flag | Description | |||
|---|---|---|---|---|
--dry-run |
Preview changes without applying | |||
--verbose / -v |
Detailed output | |||
--config propre.yml |
Custom rules | |||
--fix |
Apply safe fixes outside fix command |
|||
--ignore <pattern> |
Exclude paths | |||
--ci |
Exit non-zero if blockers found | |||
| `--format terminal | md | json | sarif` | Output format |
Configuration
Create a propre.yml at your project root:
stack: auto
restructure:
enabled: true
confirm: true
secrets:
deep_scan: false
severity_threshold: medium
rules:
dead_code: warn
console_logs: error
missing_types: warn
hardcoded_config: error
ignore:
- node_modules/
- .git/
- dist/
What Propre Detects
- Dead code & unused files
- Debug logs & leftover prints
- Missing typing
- Hardcoded configuration
- Project structure issues
- Secrets & credentials
- Production blockers
CI Integration
Example GitHub Action step:
propre scan . --ci
The command exits with a non-zero code if blocking issues are found.
Philosophy
Modern coding workflows generate code faster than they validate it.
Propre acts as the final safety layer between experimentation and deployment:
- AI coding assistants create
- Developers iterate
- Propre hardens
License
MIT
Metadata
Release files for propre-cli 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| propre_cli-0.1.1.tar.gz | 26.1 kB | Without provenance | Details for propre_cli-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| propre_cli-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for propre_cli-0.1.1-py3-none-any.whl |
Total release size: 58.1 kB
Release files / propre_cli-0.1.1.tar.gz
| Download URL | propre_cli-0.1.1.tar.gz |
|---|---|
| Size | 26.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b54e01457dfa3b0d064cfedb7971cee41c53da0df8f31b1109542054f2def3cc
|
|
BLAKE2b-256 checksum How to use checksums |
5c8522d085107a9060d57f6a0324c0595114de182abbcee64096dd931c308fa4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.7
|
Release files / propre_cli-0.1.1-py3-none-any.whl
| Download URL | propre_cli-0.1.1-py3-none-any.whl |
|---|---|
| Size | 32.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1a3a96ae6bbdb0f3d910960e690f7c7db7829d57f34130b79917304c8d0846aa
|
|
BLAKE2b-256 checksum How to use checksums |
3626b88230969555604e21d92b2c7bdfa87c7b11879b1179f5aea2dcdea1b1b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.7
|
Security for propre-cli 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.