From install to insight in under 2 minutes.
ConsoleSentinel is designed to work with zero friction. Install it, point it at your URL, and get a comprehensive quality report. No accounts, no dashboards to configure, no agents to deploy.
Install
One command. Zero dependencies to manage.
ConsoleSentinel ships as a single npm package with Chromium bundled. Use npx for one-off scans or install globally for CI/CD pipelines.
# Run instantly with npx (no install needed)npx consolesentinel --url https://your-site.com# Or install globallynpm install -g consolesentinel# Or add to your projectnpm install --save-dev consolesentinelConfigure
Optional. Works out of the box.
ConsoleSentinel works with zero config — just give it a URL. For advanced use, drop a consolesentinel.config.json to customize thresholds, modules, auth, and integrations.
{ "url": "https://your-site.com", "maxPages": 100, "viewport": { "width": 1440, "height": 900 }, "modules": { "dast": { "enabled": true, "owasp": true }, "seo": { "enabled": true, "minScore": 80 }, "visualAi": { "enabled": true, "threshold": 0.95 } }, "integrations": { "slack": { "webhook": "$SLACK_WEBHOOK_URL" } }, "thresholds": { "maxCritical": 0, "maxHigh": 3, "minScore": 70 }}Scan
Autonomous crawling with full browser context.
ConsoleSentinel launches a real Chromium browser, crawls your site following links, and runs all 27+ auditor modules on every page. Console errors, network requests, performance metrics, SEO, security — everything captured in parallel.
# Full site scan with all modulesconsolesentinel scan --url https://your-site.com --max-pages 100# CI mode — exit code 1 if thresholds are exceededconsolesentinel scan --url https://your-site.com --ci --fail-on critical# Target specific pagesconsolesentinel scan --url https://your-site.com/checkout --single-page# Launch the real-time dashboardconsolesentinel serve --port 9400Act
Machine-readable results. Human-friendly reports.
Every scan produces structured JSON and a scored summary. Pipe results to Slack, Jira, PagerDuty, or any webhook. Use the built-in dashboard for interactive exploration. Gate your CI pipeline on quality thresholds.
// CI/CD Pipeline — GitHub Actions example// .github/workflows/qa.ymlname: QA Gateon: [pull_request]jobs: consolesentinel: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: npm ci && npm run build - run: npx serve -s build -l 3000 & - run: | npx consolesentinel \ --url http://localhost:3000 \ --ci \ --fail-on high \ --output ./qa-report.json - uses: actions/upload-artifact@v4 with: name: qa-report path: ./qa-report.jsonUse it your way
Four ways to integrate ConsoleSentinel into your workflow.
CLI
Run scans from any terminal. Perfect for local development and ad-hoc audits.
CI/CD Pipeline
Gate deployments on quality thresholds. Supports GitHub Actions, GitLab CI, Jenkins, and more.
Dashboard
Real-time web dashboard on port 9400 with WebSocket updates, scan history, and drill-down views.
Programmatic API
Import ConsoleSentinel as a Node.js module. Full TypeScript types for custom integrations.
Ready to stop shipping blind?
Get started in under 60 seconds. No account required for the open-source CLI. Run your first scan and see what your users have been hiding from you.
$ npx consolesentinel --url https://your-site.com