Ship Healthier Code.

Creates a .ph-cache/ directory, generates a default project-health.config.ts, installs a post-commit git hook, and drops you into an interactive shell. Running ph scan without prior init will auto-run this step.

Produces a weighted health score from 0–100 across CI/CD, code quality, docs, flakiness, security, PR complexity, environment integrity, and build performance.

No re-analysis. Reads the result from .ph-cache/ and prints the aggregate score along with per-module breakdown instantly.

Runs only security and environment modules by default with a 60-second timeout. Built to fail fast inside your CI pipeline without the full scan overhead.

Detects which files changed versus main and runs only the relevant modules. Reports an impact score, new findings, and resolved issues compared to baseline.

Renders a sparkline trajectory of your health score over time directly in the terminal. See whether your codebase is improving or degrading commit by commit.

Launches a REPL with RAG-backed context from your AST index. Answers reference specific files and line numbers. Supports one-shot mode: ph chat "explain the auth flow".

Analyzes your staged diff or a specific GitHub PR number. Provides a senior-level review with targeted findings. Can post the review directly as a GitHub PR comment.

Analyzes file structure, entry points, code ownership from git history, and complexity indicators. Uses AI to write a comprehensive onboarding guide into ONBOARDING.md.

Exports directory structure, file contents, git diffs, and recent commits into a single XML optimised for LLM consumption. Supports splitting large repos into multiple files.

Opens a web browser with a file tree heat map (hot red → cold green based on activity), clickable commit history with inline diffs, and an overview tab with module scores and top findings.

Circular health gauge, module bars, severity-sorted findings, priority actions. Uses server-sent events for live push updates. File watcher auto-rescans on save.

Interactive mode: pick findings to fix. Auto mode: fixes top critical issues. AI mode handles complex fixes like JSDoc generation, complexity refactoring, dead code removal. Commit to new branch with --commit.

ph config wizard — interactive setup for modules, scoring weights, complexity thresholds, and API tokens. ph config get <key> / ph config set <key> <val> for individual values.

ph auth login stores a JWT in your OS keychain. ph auth logout removes it. ph auth status checks if you're currently authenticated.

Launched automatically after ph init. All commands work inside the shell without the ph prefix. Type help to list commands and exit to quit.

Pulls file-level and line-level context from your AST index. One-shot: ph chat "explain auth flow". Full-context mode loads the entire repo for richer answers.

Analyzes diff context and produces targeted findings. With --post it comments the review directly on the GitHub PR.

Uses git history for ownership analysis, entry-point detection, and complexity indicators to create a rich developer guide. Stays fresh with --update.

Standard mode fixes lint and simple issues. With --ai it handles complex refactors. Use --dry-run to preview every change before it's applied.