🔎
Auto-detects your stack
Reads package.json, pyproject.toml, lockfiles — then picks npm / pnpm / yarn automatically.
v1.2.0 · now on PyPI, Homebrew & Scoop
Stop your AI agent from declaring
Stop your AI agent from declaring
“done” on broken code.
A universal quality gate that runs Typecheck → Lint → Test → Security Audit before any task is marked complete. Auto-detects Node.js and Python. Works with 10 AI coding tools. Zero runtime dependencies.
pipx install pre-flight-check
1Typecheck
→
2Lint
→
3Test
→
4Security Audit
→
✓ cleared
The problem
Your AI agent writes a function, watches it not throw at runtime, and
reports “done” — while tsc would have caught a type
error in 50 ms, eslint would have flagged dead code,
and pytest would have failed three tests.
pre-flight-check closes that loop. One command, four gates,
structured failure output the agent has to act on. No more
“I’ve successfully implemented the feature!” while the build is on fire.
### ❌ PRE-FLIGHT FAILURE: TYPECHECK **Command Executed:** `npx --no-install tsc --noEmit` **Context for AI Fix:** src/auth/session.ts(42,18): error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'.
Built to be impossible to fake-pass
The agent reads the failure block and must fix the exact error before continuing.
🛑
Fail-fast pipeline
The first failing stage halts everything and exits 1. No point linting code that doesn’t typecheck.
🚫
No escape hatches
Bans @ts-ignore, # type: ignore, deleting tests, and ignore-list edits. Green means fixed.
🛠️
Uses your own scripts
If package.json defines lint, it runs npm run lint — your config, your rules.
📦
Zero dependencies
The whole engine is one Python file with no runtime deps. Audit it in five minutes.
🤖
10 AI tools, one install
Claude, Codex, Gemini, Cursor, Copilot, Windsurf, Cline, Kiro, Roo, and the Agent Skills standard.
Four gates, two runtimes
Stages whose tools aren’t installed are skipped silently — no false positives.
| Stage | Node.js | Python |
|---|---|---|
| 1 Typecheck | tsc --noEmit | mypy . |
| 2 Lint | eslint . | ruff check . → flake8 |
| 3 Test | jest / vitest | pytest -q |
| 4 Security | npm audit | pip-audit → bandit |
Install in one line
Pick your platform. Then run pre-flight-check init --tool all --project in any repo.
pipx install pre-flight-checkbrew tap mirekondro/pre-flight-checkbrew install pre-flight-checkscoop bucket add pre-flight-check https://github.com/mirekondro/The-Pre-Flight-Checkscoop install pre-flight-checkcurl -fsSL .../install.sh | bashirm .../install.ps1 | iexclaude plugin marketplace add mirekondro/The-Pre-Flight-Checkclaude plugin install pre-flight-checkWorks with your AI tool
One install writes the native instruction file each tool already reads.
Claude Code.claude/skills/
OpenAI CodexAGENTS.md
Gemini CLIGEMINI.md
Cursor.cursor/rules/
GitHub Copilot.github/copilot-instructions.md
Windsurf.windsurf/rules/
Cline.clinerules/
Kiro.kiro/steering/
Roo Code.roo/rules/
Agent Skills.agents/skills/
Ship code that actually works.
Add a real quality gate to your AI workflow in under a minute.
pipx install pre-flight-check