# Gaffer

> Test analytics platform that stores, analyzes, and shares test results and coverage reports. Gives AI agents memory of your test history.

Gaffer is a SaaS for engineering teams who want to track test results over time, detect flaky tests, analyze coverage trends, and share reports with stakeholders. Works with any CI and any test framework that outputs JUnit XML, CTRF, or other standard formats.

## CLI (Primary Interface)

- [Getting Started](https://gaffer.sh/docs/getting-started/): 5-minute setup with any CI
- [CLI Reference](https://gaffer.sh/docs/cli/): Commands: test, query, sync, affected-tests, doctor
- [Upload API](https://gaffer.sh/docs/upload-api/): HTTP API for custom integrations

## AI Agent Integration

- [AGENTS.md](https://gaffer.sh/AGENTS.md): How an agent installs and uses Gaffer (CLI, agent skill, MCP server)
- [auth.md](https://gaffer.sh/auth.md): How an agent authenticates to the Gaffer API. A CI job with `permissions: id-token: write` gets a project token with no secret to store (OIDC token exchange); a human running the CLI gets one via `gaffer login` (RFC 8628 device code). Bearer tokens and API keys both still work
- [ai-catalog.json](https://gaffer.sh/.well-known/ai-catalog.json): ARD capability catalog of every agent-facing surface Gaffer publishes
- [MCP Server](https://gaffer.sh/docs/mcp/): npm install @gaffer-sh/mcp — give Claude/Cursor memory of your tests
- [Agent Skill](https://github.com/gaffer-sh/agent-skills): npx skills add gaffer-sh/agent-skills
- [WebMCP tools](https://gaffer.sh/blog/webmcp-agent-callable-marketing-site/): every gaffer.sh page registers gaffer.search_docs, gaffer.get_pricing, gaffer.install_mcp, gaffer.signup_url on document.modelContext

## CI Providers

- [GitHub Actions](https://gaffer.sh/docs/guides/github-actions/)
- [GitLab CI](https://gaffer.sh/docs/guides/gitlab-ci/)
- [CircleCI](https://gaffer.sh/docs/guides/circleci/)
- [Jenkins](https://gaffer.sh/docs/guides/jenkins/)
- [Azure DevOps](https://gaffer.sh/docs/guides/azure-devops/)
- [Bitbucket Pipelines](https://gaffer.sh/docs/guides/bitbucket-pipelines/)

## Sharing Test Reports by Framework

- [Playwright](https://gaffer.sh/solutions/share-playwright-test-reports/): Share Playwright HTML reports without hosting them yourself
- [Jest](https://gaffer.sh/solutions/jest-test-reporting/): Share Jest results with your team
- [Vitest](https://gaffer.sh/solutions/vitest-test-reporting/): Share Vitest results with your team
- [pytest](https://gaffer.sh/solutions/pytest-test-reporting/): Share pytest results with your team
- [Cypress](https://gaffer.sh/solutions/cypress-test-reporting/): Share Cypress results with your team
- [.NET](https://gaffer.sh/solutions/dotnet-test-reporting/): Share .NET test results with your team

## Common Problems

- [Host test reports past CI artifact expiration](https://gaffer.sh/solutions/host-test-reports/)
- [Share reports with anyone, no login required](https://gaffer.sh/solutions/shareable-test-report-links/)
- [Find which tests are unreliable](https://gaffer.sh/solutions/flaky-test-detection/)
- [Debug root causes instead of individual tests](https://gaffer.sh/solutions/failure-clustering/)
- [Analyze test failures across CI runs](https://gaffer.sh/solutions/analyze-test-failures/)
- [Track code coverage trends over time](https://gaffer.sh/solutions/code-coverage/)
- [Get alerted in Slack, not CI logs](https://gaffer.sh/solutions/test-failure-notifications/)
- [See test results without leaving GitHub](https://gaffer.sh/solutions/github-pr-test-status/)

## Optional

- [Coverage Tracking](https://gaffer.sh/docs/coverage/)
- [Slack Integration](https://gaffer.sh/docs/integrations/slack/)
- [Webhooks](https://gaffer.sh/docs/integrations/webhooks/)
- [OpenTelemetry Export](https://gaffer.sh/docs/integrations/opentelemetry/)
- [Status Badges](https://gaffer.sh/docs/badges/)
- [All solutions](https://gaffer.sh/solutions/): Full index of problem-oriented guides
- [Blog](https://gaffer.sh/blog/): Testing practice, CI workflows, and dogfooding write-ups
- [Pricing](https://gaffer.sh/#pricing): Free 500MB, Pro $15/mo, Team $49/mo, unlimited users on every plan
- [llms-full.txt](https://gaffer.sh/llms-full.txt): Full documentation and solutions corpus in one file