wcheck is a professional CLI tool designed to stress-test and audit your web applications using a headless browser. It simulates real user behavior to catch bugs that traditional crawlers miss, such as JavaScript crashes, broken interactions, and hidden network failures.
wcheck operates in three distinct phases:
- Scout Phase: The tool navigates to the target URL and discovers all internal links to build a scan queue.
- Scan Phase: Multiple parallel workers visit each discovered page, monitoring for JS exceptions, console errors, and 4xx/5xx network failures.
- Interact Phase (Smarter Monkey): For each page, the "Monkey" identifies all interactive elements (buttons, links, inputs) and simulates clicks to trigger state-dependent bugs.
- Headless Browser: Uses real Chrome/Chromium via
chromedpto execute JavaScript. - Concurrent Scanning: Worker pool pattern for high-speed audits.
- Smarter Interaction Monkey: Coordinate-based clicking that bypasses transparent overlays and waits for hydration.
- Deep Dive Reporting: Detailed reports with stack traces, line numbers, and color-coded error categories.
# Install (requires Go 1.23+)
make build
sudo make install
# Scan a website with interaction testing
wcheck scan https://example.com -iSee INSTALL.md for detailed setup and USAGE.md for command examples.