Verify Every PR
Drop Assay into your CI/CD pipeline. Catches hallucinated bugs before they merge.
Quick Start
Create .github/workflows/assay.yml in your repository. That is it — Assay will verify every pull request automatically.
name: Assay Verification
on: [pull_request]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: gtsbahamas/hallucination-reversing-system/github-action@main
with:
assay_api_key: ${{ secrets.ASSAY_API_KEY }}BYOK Mode (Bring Your Own Key)
Two modes. Use your Assay API key (recommended) or bring your own Anthropic key.
Assay API Key (recommended)
- Managed verification pipeline
- Dashboard with history
- Free tier: 50 verifications/month
Anthropic Key (BYOK)
- Use your own Anthropic credits
- No Assay account required
- No dashboard or history
To use BYOK mode, swap the key in your workflow:
- uses: gtsbahamas/hallucination-reversing-system/github-action@main
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}Configuration Options
| Input | Description | Default |
|---|---|---|
| assay_api_key | Your Assay API key. Get one at Dashboard → API Keys | — |
| anthropic_api_key | Alternative: use your own Anthropic key instead | — |
| target_dir | Directory to verify | . |
| fail_on | When to fail the check: critical | high | any | critical |
Full example with all options:
name: Assay Verification
on: [pull_request]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: gtsbahamas/hallucination-reversing-system/github-action@main
with:
assay_api_key: ${{ secrets.ASSAY_API_KEY }}
target_dir: ./src
fail_on: highWhat It Reports
On every pull request, Assay posts a comment with the verification results and sets a check status based on your fail_on threshold.
Assay Verification Report
SQL injection in user search endpoint
Empty cart checkout not handled
Claims extracted, pass/fail verdicts, and remediation suggestions posted directly on the pull request.
The GitHub check passes or fails based on your fail_on threshold. Critical-only by default.
Each failed claim includes a specific fix suggestion so your team knows exactly what to change.
Getting Your API Key
- 1Sign up at tryassay.ai
- 2Go to Dashboard → API Keys
- 3Copy your key
- 4Add to your GitHub repo:
Settings → Secrets and variables → Actions → New repository secret
Name:
ASSAY_API_KEY— Value: your key
Free for open source repositories. 50 verifications/month on the free tier.
Prefer the CLI or your editor?
Assay also runs as a CLI tool and an MCP server for Claude Code, Cursor, and Windsurf.