PUIUX Pilot

[](https://github.com/PUIUX-Cloud/puiux-pilot/actions/workflows/ci.yml) [](LICENSE) [](https://www.npmjs.com/package/puiux-pilot) [](https://nodejs.org) [](https://puiux.com/)

**One command to scan, configure, and optimize any project for Claude Code.**

[Getting Started](#getting-started) | [Commands](#commands) | [Safety Model](#safety-model) | [Contributing](CONTRIBUTING.md)

---

Adaptive AI coding assistant configurator for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Scans your project, detects the stack (95+ project types), selects the right hooks/MCPs/skills, and configures everything automatically.

Getting Started

npm i -g puiux-pilot
cd your-project
puiux-pilot init            # dry-run: shows what it would do
puiux-pilot init --apply    # apply changes (backup created first)

More commands

puiux-pilot scan            # project DNA without changes
puiux-pilot score           # quality score (0-100, A-F)
puiux-pilot doctor          # health check
puiux-pilot eject           # clean removal

Commands

Command	What it does
init	Scan project, select hooks/MCPs/skills, show plan. Dry-run by default.
init --apply	Write changes (backup created first).
init --force	Overwrite user-modified hooks.
scan [path]	Analyze project without changing anything. Shows Project DNA.
score [path]	Quality assessment: 6 dimensions, 0-100, A-F grade.
doctor	Health check: broken hooks, missing scripts, timeouts, orphans.
hooks list	List all hooks with status.
translate	[EXPERIMENTAL] Translate config between AI coding tools.
eject	Clean removal. Restores original state from backup.

Safety Model

• Dry-run by default — init shows what would change without writing anything.
• Backup before every apply — stored in ~/.puiux-pilot/backups//.

...