Skip to main content

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)

Source distribution for propre-cli 0.1.1
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)

Table of built distributions (wheels) for propre-cli 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page