Introduction

Gaffer wraps your test command and extracts flaky tests, failure clusters, health scores, and coverage trends from raw results. Same data in three places:

• CLI — gaffer test enriches your terminal output after every run
• Dashboard — your team sees history, trends, and share links at app.gaffer.sh
• MCP server — AI coding agents (Claude Code, Cursor, Windsurf) query your test data and act on it

What you get

• Flaky test detection — flip rates, composite scores, and history for every test that alternates between pass and fail
• Failure clusters — groups failing tests by shared error patterns so you fix root causes, not symptoms
• Health scores — a single 0–100 number combining pass rate, flakiness, and trend direction
• Coverage tracking — line, branch, and function coverage with GitHub commit status gating
• Duration analysis — P50/P75/P90/P95/P99 percentiles and slowest test identification
• Works with everything — Playwright, Jest, Vitest, pytest, Go, RSpec, JUnit XML, CTRF, and any CI provider

How it works

# Install
curl -fsSL https://app.gaffer.sh/install.sh | sh

# Wrap your test command
gaffer test -- npm test

Gaffer runs your tests, discovers report files, parses results, computes analytics, prints an enriched summary, and syncs to the cloud — all in one command. Your test command’s exit code passes through unchanged.

Next steps

Head to the Getting Started guide to install the CLI and run your first test.