# CheckHere

CheckHere v0.4.0 is a free, open-source, local-first browser release check for AI-built websites.
Browser execution, screenshots, findings, and reports stay on the user machine or CI runner.

## Source

- GitHub: https://github.com/Ryan-yang125/checkhere
- Releases: https://github.com/Ryan-yang125/checkhere/releases
- Skills.sh: https://skills.sh/ryan-yang125/checkhere/checkhere
- License: https://github.com/Ryan-yang125/checkhere/blob/main/LICENSE

## Install and run

curl -fsSL https://checkhere.page/install.sh | bash
checkhere setup
checkhere https://your-site.com
checkhere ci https://your-site.com --fail-on=critical

## Local output

- report.html: visual report with desktop and mobile screenshots.
- report.md: agent-readable findings and recommended fixes.
- report.json: stable machine-readable report data.
- fix-prompt.md: compatibility alias for the agent Markdown report.

## Documentation

- CLI: https://checkhere.page/docs/cli
- Agent Skill: https://checkhere.page/docs/skill
- GitHub Actions: https://checkhere.page/docs/github-actions
- AI website launch checklist: https://checkhere.page/guides/ai-website-launch-checklist
- Broken image check: https://checkhere.page/checks/broken-image
- Mobile overflow check: https://checkhere.page/checks/mobile-overflow
- Console error check: https://checkhere.page/checks/console-error

## Agent workflow

1. Start the project development server or obtain its preview URL.
2. Run CheckHere locally against the URL.
3. Open report.html for screenshot evidence.
4. Read report.md or report.json and fix actionable issues within the user authorization.
5. Run CheckHere again and compare the result.
6. Skill source: https://github.com/Ryan-yang125/checkhere/tree/main/skills/checkhere

## Checks

CheckHere covers HTTP status, blank pages, metadata, desktop and mobile screenshots, console and page errors, failed requests, broken images, mobile overflow, route coverage, SEO signals, and Lighthouse lab metrics.

## Fixed example

- HTML: https://checkhere.page/examples/v0.4.0/report
- Markdown: https://checkhere.page/examples/v0.4.0/report.md
- JSON: https://checkhere.page/examples/v0.4.0/report.json

The example links are read-only reference artifacts. New scans run locally.