RepoDx

Check your AI-built project before you push it. One command, zero dependencies, and nothing leaves your machine.

Coding agents such as Cursor, Claude Code, Lovable, Bolt and Replit ship apps fast. They also paste API keys into source files, commit .env files, create Supabase tables without Row Level Security and leave Firebase rules wide open. In 2025, public GitHub commits leaked about 28.6 million new secrets, and leaked AI-service keys grew 81% in one year (GitGuardian, State of Secrets Sprawl 2026). Bots find a leaked key within minutes.

RepoDx scans your project folder, gives it a score, and tells you in plain language how to fix each problem.

Installation

Install from PyPI with an isolated tool manager:

pipx install repodx
# or
uv tool install repodx

Run it once without installing anything (Python 3.9+ is the only requirement):

curl -sSL https://github.com/omerbek/repodx/releases/latest/download/repodx.py | python3 - .

Install the tagged GitHub version directly:

pipx install git+https://github.com/omerbek/repodx@v0.5.0
# or
uv tool install git+https://github.com/omerbek/repodx@v0.5.0

On Windows, you can also download repodx.py and run python repodx.py .

Usage

repodx                    # scan the current folder
repodx path/to/project    # scan another folder
repodx --fix              # apply safe fixes, then scan again
repodx --prompt           # prompt to paste into Cursor, Claude Code or Lovable
repodx --install-hook     # block commits with critical findings
repodx --json             # machine-readable output
repodx --quiet            # one-line score for scripts and hooks
repodx --format markdown  # report for PR comments or CI summaries
repodx --badge            # print a README badge with your score
repodx --fail-on critical # only fail on critical findings (default: warning)

Exit codes: 0 means nothing at or above --fail-on was found, 1 means something was found, and 2 means the path is not a folder.

Fix it

repodx --fix applies the fixes that are always safe, then scans again:

• adds the missing lines to .gitignore (.env, node_modules/, *.log, ...) and creates the file if it doesn't exist
• creates a .env.example with the variable names from your .env files and code, with the values left empty

It never deletes files, touches Git history or edits your code. For the rest it prints what to do yourself, such as git rm -r --cached for files Git already tracks and rotating leaked keys. Running it twice changes nothing.

repodx --prompt prints a prompt for your AI coding tool: every problem with its location and fix, plus rules such as "never print or commit secret values" and "run repodx . when you're done". Paste it into Cursor, Claude Code, Lovable or Bolt.

repodx --install-hook installs a Git pre-commit hook, so a commit is blocked while RepoDx finds a critical problem such as a leaked key or an unignored .env file. A secret stopped before the commit never enters your Git history. Skip the check once with git commit --no-verify. RepoDx doesn't overwrite a pre-commit hook that it didn't install.

GitHub Action

# .github/workflows/repodx.yml
name: repodx
on: [push, pull_request]
jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: omerbek/repodx@v0.5.0
        with:
          fail-on: warning # critical, warning, info or never

The action writes the report to the job summary and fails the job when it finds problems.

pre-commit hook

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/omerbek/repodx
    rev: v0.5.0
    hooks:
      - id: repodx

Badge

Run repodx --badge and paste the output into your README:

[![repodx](https://img.shields.io/badge/repodx-A%2094%2F100-brightgreen)](https://github.com/omerbek/repodx)

What it checks

To keep false alarms rare, RepoDx:

• skips values that look like documentation placeholders (AKIAIOSFODNN7EXAMPLE, [YOUR-PASSWORD], xoxb-0000..., -----BEGIN PRIVATE KEY-----\n...) and the public demo keys of the local Supabase CLI
• reports secrets and .env files in test and example folders as warnings, not critical
• only expects node_modules/ in .gitignore when there is a package.json, and __pycache__/ when there are Python files

RepoDx reads your .gitignore, including ! re-include rules. Files that Git would not commit are not reported, and ignored folders are not scanned. Found secrets are masked in the output (sk-pro...l2).

The score starts at 100. Each critical finding subtracts 25, each warning 8 and each info 2, and each kind of problem counts at most three times. Grades: A ≥ 90, B ≥ 80, C ≥ 65, D ≥ 50, F below 50.

Tested on real projects

Before each release, RepoDx is run on large public repositories to catch false alarms. Results for 0.3.0:

The first version of these checks raised 136 critical alarms on the same repositories. Almost all of them were documentation placeholders and test fixtures, and the rules above were added to filter them out.

Silencing false positives

• Add repodx:ignore in a comment on the line to skip that line.

• Add a .repodxignore file (gitignore syntax) to skip whole paths, such as test fixtures:

  tests/fixtures/
  docs/examples/*.md
  

What RepoDx does not do

• It scans the files in your folder, not your Git history. If a key was ever pushed, rotate it: deleting the file does not remove it from history. For history scans, use Gitleaks or TruffleHog.
• It does not connect to your live Supabase or Firebase project. The RLS and rules checks only read the files in your repo.
• It is a fast first check, not a full security audit.

Contributing

First-time contributors are very welcome. Each good first issue is a small, self-contained task, usually adding one secret provider with a test, and explains exactly which lines to change. Comment on an issue to claim it, then open a PR. See CONTRIBUTING.md.

Found a false alarm or a missed secret? Open an issue with the line (with the secret replaced).

Contributors

Thanks to everyone who has made RepoDx better:

Support

RepoDx is free and MIT licensed. If it saved you from a leaked key:

• Star the repo, it helps other people find it.

• Report false alarms and missed problems in issues.

• Sponsor on GitHub: https://github.com/sponsors/omerbek

• Donations are welcome at this Ethereum address (ETH or ERC-20 tokens on Ethereum mainnet):

  0xb74e0A471bC60BB52067353C024e9bBA5a123F48
  

Development

RepoDx is a single Python file with no dependencies, so it is easy to read and extend. Each check is a small function in repodx.py that returns findings.

The sample_repo/ folder is intentionally broken, and every credential in it is fake. It is used by the tests and by the example above.

Run the test suite:

python3 -m unittest discover

Adding a check:

1. Write a function that returns make_finding(...) results.
2. Add its fix text to FIXES.
3. Call it from build_report.
4. Add a test in tests/test_repodx.py.