whatisgithub

What is preflight?

amitsarin1/preflight — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · vibe coderComplexity · 1/5LicenseSetup · easy

In one sentence

An offline scanner that checks a vibe-coded project for dead code, leaked secrets, and missing basics, then gives it a ship-readiness score out of 100.

Mindmap

mindmap
  root((repo))
    What it does
      Scans for dead code
      Finds hardcoded secrets
      Gives ship score
    Tech stack
      Python
      CI
    Use cases
      Pre-ship code check
      CI quality gate
    Audience
      Vibe coders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check an AI-built app for dead code, leaked API keys, and missing tests before launch.

USE CASE 2

Add a ship-readiness score gate to a CI pipeline that fails builds below a threshold.

USE CASE 3

Find leftover files like final_v2.py and duplicated code left behind during vibe coding.

What is it built with?

Python

How does it compare?

amitsarin1/preflight0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity1/54/51/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No dependencies beyond Python, install via pip or use the double-click launcher with no terminal.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1
Run preflight demo to show me an example ship-readiness report before I scan my real project.
Prompt 2
Help me fix the hardcoded secret finding preflight reported in my config.py file.
Prompt 3
Explain what each check in preflight's table catches and why it matters before shipping.
Prompt 4
Show me how to add preflight with --fail-under 75 to my CI pipeline.

Frequently asked questions

What is preflight?

An offline scanner that checks a vibe-coded project for dead code, leaked secrets, and missing basics, then gives it a ship-readiness score out of 100.

What language is preflight written in?

Mainly Python. The stack also includes Python.

What license does preflight use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is preflight to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is preflight for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.