What do you want to do?
3 use cases
-
Catch broken controls in a page an agent just wrote
Run Assay after an agent finishes a page and get a one-line pass or fail result.
- Assay
- Claude Code
- Codex
- Cursor
- Gemini CLI
- Software and DevOps
- Intermediate
View prompt
Use the assay CLI from the assay-ui package on the page in <folder path>. Run assay <folder path> --one-line, then report the one-line summary in your reply. Verify that the exit code is zero before you tell the user the page passed.
-
Produce a visual QA report for a page with screenshots
Write an HTML report that shows what Assay checked and what failed, with screenshots.
- Assay
- Software and DevOps
- Beginner
View prompt
Use the assay-ui package to check the page folder <folder path> and write an HTML report to <report path>. Run assay <folder path> --report <report path>, then confirm the report file exists and list the flagged checks from the terminal output.
-
Stop a build when a page fails Assay checks
Use Assay's non-zero exit code to block a page from moving forward when it has a flagged problem.
- Assay
- Software and DevOps
- Advanced
View prompt
Add an assay check to the build script in <repo path>. After the build writes to <output folder>, run assay <output folder> --one-line and stop the script if the exit code is non-zero. Verify by running the script against a page with a known broken control and confirming it stops.
How to use Assay
- Check you have what it needs: Python 3.10+, or uv or pipx to install the tool; A folder containing built web page output, with index.html or another page to check; Internet access for the first run, when Chromium may be downloaded.
- Open awss1i/assay on GitHub and read the README and license.
- Run
pip install assay-uito install the tool. - Run
assay ./my-app --one-lineagainst the folder that holds the page, replacing ./my-app with your folder. - Read the summary line, which reports the page checked, the number of checks, and anything flagged.
- If anything is flagged, have the agent fix the listed problem and run the same command again.
These steps come from our top use case, Catch broken controls in a page an agent just wrote, which also has a copy-paste agent prompt.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers and coding-agent users who build or edit static web pages and want a deterministic check before calling the page done.
- Why it is hot
- LanguagePython
- Sourcegithub.com/awss1i/assay · Back to Hot repos
Requirements
- Python 3.10+, or uv or pipx to install the tool
- A folder containing built web page output, with index.html or another page to check
- Internet access for the first run, when Chromium may be downloaded
Add this badge to your README
Maintain Assay? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/awss1i-assay/?utm_source=github&utm_medium=badge&utm_campaign=awss1i-assay)
HTML
<a href="https://dedupedai.com/use-cases/awss1i-assay/?utm_source=github&utm_medium=badge&utm_campaign=awss1i-assay"><img src="https://dedupedai.com/badge/awss1i/assay.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Assay
What is Assay?
assay is an agent-native command-line QA tool that opens a local web page in Chromium, uses every control it finds, and reports what went wrong, with no tests to write and no LLM. It is an open-source project on GitHub: https://github.com/awss1i/assay.
Who is Assay for?
Developers and coding-agent users who build or edit static web pages and want a deterministic check before calling the page done.
What can I do with Assay?
3 use cases so far, for example: Catch broken controls in a page an agent just wrote; Produce a visual QA report for a page with screenshots; Stop a build when a page fails Assay checks. Each has steps and a copy-paste agent prompt.
What do I need to run Assay?
Python 3.10+, or uv or pipx to install the tool; A folder containing built web page output, with index.html or another page to check; Internet access for the first run, when Chromium may be downloaded.
What are alternatives to Assay?
Other hot AI repos in Software and DevOps: Omarchy Local AI, Hermes Plan Mode, Agent 2, Agnes Harness, Skills.
Is Assay safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.