Documentation

Get coverage on your PR in one loop

tested.dev is patch coverage for humans and coding agents. One setup path, then the few references you need.

For agents. Copy this into Cursor / Claude / your coding agent, or point it at /llms.txt + /llms-full.txt.

You are setting up tested.dev (patch coverage gate) on this repo.

1. Fetch https://tested.dev/llms.txt and https://tested.dev/llms-full.txt
2. For auth: https://app.tested.dev/.well-known/agent-configuration and https://app.tested.dev/auth.md (Better Auth Agent Auth. Do not invent endpoints)
3. Follow Install: https://tested.dev/docs/install
4. Need Node 24+.
5. Install: pnpm add -D @tested/cli. After install, td is the same CLI. One-off: npx @tested/cli.
6. Local tested diff and tested check need no account. tested run writes coverage even if tests fail.
7. CI gate: tested-hq/cli/action@main with version: 0.1.10. push defaults to false. No token. Pin uses: to a SHA in production. fetch-depth: 0 is optional.
8. Optional share: install https://github.com/apps/tested-dev-app, mint TESTED_TOKEN at https://app.tested.dev/repos/{owner}/{name}/settings. Settings shows the 64-character hex once. Env: TESTED_TOKEN or TESTED_TOKEN_FILE. API URL: TESTED_API_URL. Never print or commit it. Then push: true.
9. If blocked, run tested doctor --json and fix FAILs.

Report what you changed and the next human step (install App / paste token secret / approve agent at /device/capabilities).

Goal: Node 24 + coverage + tested check. No account for local or the Action gate. Token + tested-dev-app for share/push. Hobby adds sticky comments and App-posted required checks. If anything fails, run tested doctor.

Install →

Node 24+, @tested/cli. Local diff/check need no account.

GitHub Action →

Gate with push default false. Optional share + mainline.

Migrate from Codecov →

Swap the gate and the project view. Then Codecov comes out.

Troubleshooting →

Node 24, tokens, doctor.

The loop

tested setup
# tests with coverage  (tested run writes coverage even if tests fail)
tested diff              # report. exit 0. no account
tested check             # gate. no account
tested push --pr <n>     # optional. needs TESTED_TOKEN
# → https://app.tested.dev/share/…

Surfaces

Surface	Use it for
App	tested-dev-app, tokens, dashboard, share pages, billing
CLI	Local coverage. `td` alias. diff is a report. check is the gate. Neither needs an account. push needs a token
MCP	Agents: uncovered ranges, explain line, write_and_verify
Action	CI check + push on pull_request / main

Machine-readable

/llms.txt is the index for AI crawlers / agents.
/llms-full.txt is the full setup pack in one file.
/.well-known/agent-configuration is Better Auth Agent Auth discovery (JSON).
app.tested.dev/auth.md is the same BA APIs, markdown companion.
/api/auth/reference is Better Auth OpenAPI.

Plans (short)

Free — public repos + 1 private; share links; no comments, no App-posted required checks; 250 private uploads / mo
Hobby $5/seat/mo · $48/yr — unlimited private, sticky comments, App-posted required checks, 2,500 private uploads / mo, max 10 seats
Team $10/seat/mo · $96/yr — unlimited seats, project coverage, full history, per-repo thresholds, unlimited uploads

Live demo (no signup): app.tested.dev/demo