4 Steps

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.

01

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.

bash
# 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 consolesentinel
02

Configure

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.

consolesentinel.config.json
{  "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  }}
03

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.

bash
# 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 9400
04

Act

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.

.github/workflows/qa.yml
// 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.json

Use 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