# millionco/expect

Expect tests your agent's code in a real browser

Repository: https://github.com/millionco/expect
Canonical: https://ross.abutalabs.com/products/expect
Homepage: https://expect.dev
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: agent, browser, test, expect
Last push: 2026-05-06T07:58:53+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 81, release rhythm 78, longevity 12
- inputs: {"age_days": 174, "days_push": 119, "days_rel": 150, "gap_med": 0, "n_releases_24m": 2}
- flags: young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3550, forks 156 (observed 2026-08-28T04:08:09.542732+00:00)

## What it is
Expect is a CLI tool and MCP skill that reads your git changes, generates a test plan, and runs it in a real browser using Playwright. It integrates with coding agents like Claude Code, Codex, and Cursor to automatically find regressions and issues, then lets the agent fix them.

## Use cases
- test my agent's code changes in a real browser
- automated QA for pull requests in CI
- find broken hover states, dead links, and missing metadata
- check performance metrics like INP and LCP on my web app
- run security checks on npm dependencies and CSRF vulnerabilities
- simulate logged-in users to catch regressions
- add browser testing to Claude Code or Cursor without writing Playwright scripts

## When to choose
- You want automated browser-based QA of code changes without maintaining test scripts or selectors
- You use AI coding agents and want them to find and fix regressions themselves
- You need PR-level testing in CI with real cookies and real browser behavior

## When to avoid
- You need mobile or cross-browser testing (not yet supported)
- You want deterministic, hand-written test suites with explicit assertions
- You need a hosted or enterprise testing service (not yet available)

## Facets
- artifact type: cli-tool
- maturity: active
- function: testing, e2e-testing, agent-framework, mcp, cli
- domain: testing, developer-tools, web-development
- platform: cli, cross-platform
- tags: browser-testing, playwright, qa-automation, agent-skill, mcp-server, code-review, ai-agents, nodejs

## Member repositories
- millionco/expect (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:09.542732+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:34:21.546130+00:00, confidence not recorded.
  - readme: https://github.com/millionco/expect (fetched 2026-08-28T04:08:09.542732+00:00, sha 814f330f4d02)
  - homepage: https://expect.dev (fetched 2026-08-29T09:28:39.195136+00:00, sha 6475e347a9cb)
- Data as of 2026-08-30T08:39:29.467469+00:00.