amitsarin1/preflight

Preflight is a tool for checking whether an app you built with AI help is actually ready to ship as a real product, not just working on your own machine. It reads through your codebase the way an experienced engineer would skim it on their first day, and points out the specific things standing in the way, such as dead code, copy-pasted duplicate files, hardcoded API keys, missing licenses and tests, leftover files like final_v2.py, and functions that are too messy for anyone to review properly. It runs entirely offline using only Python's built in tools, with no other dependencies and no calls to any AI service, so your code never leaves your machine. Every problem it finds comes with a specific suggested fix rather than just a complaint, and it produces an overall ship readiness score from 0 to 100 that you can track over time or add to your continuous integration pipeline so a bad score fails a build automatically. There are three ways to use it. Non technical users can download the repository and double click a launcher file for Mac or Windows, which installs everything and asks you to drag your project folder in before writing a report next to your project. Developers comfortable with a terminal can install it with pip and run it against their project folder directly, or try a demo mode that builds a deliberately messy sample project to scan first. It can also be added as a single command in a CI pipeline that fails the build if the score drops below a chosen threshold. The checks cover things like unreachable dead modules, hardcoded secrets from providers such as OpenAI or AWS, duplicated code blocks, undeclared dependencies, version numbers that disagree across files, silent error handling, circular imports, oversized files and functions, leftover working files, and missing basics like a README or tests. The README is upfront that these are conservative static checks meant to prompt human judgment, not a full security audit, and that Python gets the deepest analysis while JavaScript and TypeScript get a narrower set of checks. The project is released under the MIT license.