perfwatch-cli
v1.0.2
Published
Monitor web performance from your terminal — Lighthouse audits, Core Web Vitals tracking, trend analysis, and CI/CD integration
Maintainers
Readme
perfwatch-cli
Monitor web performance from your terminal. Run Lighthouse audits, track Core Web Vitals over time, and catch performance regressions in CI/CD.
Install
npm install -g perfwatch-cliUsage
Run an audit
perfwatch audit example.com
perfwatch audit example.com --mobile
perfwatch audit example.com --threshold 85 # exits 1 if score below 85
perfwatch audit example.com --json # raw JSON outputView history
perfwatch history example.com
perfwatch history example.com --last 20Compare two sites
perfwatch compare site-a.com site-b.com
perfwatch compare site-a.com site-b.com --mobileCI/CD Integration
# GitHub Actions
- run: npx perfwatch-cli audit https://your-site.com --threshold 85Metrics Tracked
| Metric | Good | Needs Work | Poor | |--------|------|------------|------| | First Contentful Paint | < 1.8s | < 3.0s | > 3.0s | | Largest Contentful Paint | < 2.5s | < 4.0s | > 4.0s | | Cumulative Layout Shift | < 0.1 | < 0.25 | > 0.25 | | Total Blocking Time | < 200ms | < 600ms | > 600ms | | Speed Index | < 3.4s | < 5.8s | > 5.8s | | Time to First Byte | < 800ms | < 1.8s | > 1.8s |
License
MIT
