@vitest-agent/plugin

Vitest plugin that turns your test suite into a live data source for LLM coding agents. Handles persistence, failure classification, coverage policy enforcement, project discovery and a configurable reporter chain — the CLI and MCP server ship as dependencies and are wired automatically.

Features

• AgentPlugin — drop into vitest.config.ts; auto-detects human, agent and CI executors and adapts console output accordingly
• Project discovery — AgentPlugin.discover() scans workspace packages, returns { projects, tags } ready for test.projects and test.tags; classification tags apply at collection time, so every test declaration form inherits them, including wrapper testers like @effect/vitest's it.effect
• Coverage presets — COVERAGE_LEVELS and COVERAGE_LEVELS_PER_FILE return dual-output { thresholds, coverageTargets } objects; COVERAGE_AUTOUPDATE tolerance functions plug into Vitest's native autoUpdate
• Failure classification — persists per-test errors, computes failure signatures, classifies tests as stable, new-failure, persistent, flaky or recovered across runs
• Custom reporters — pass any VitestAgentReporterFactory as the reporter option; the default wires DefaultVitestAgentReporter from @vitest-agent/reporter
• onRunEvent tap — optional read-only callback receiving every RunEvent in parallel with the renderer, safe to throw from

Install

npm install --save-dev @vitest-agent/plugin
# or
pnpm add -D @vitest-agent/plugin

@vitest-agent/cli and @vitest-agent/mcp ship as regular dependencies of the plugin, so they install with it on every package manager.

Quick start

import { AgentPlugin } from "@vitest-agent/plugin";
import { defineConfig } from "vitest/config";

export default async () => {
  const { projects, tags } = await AgentPlugin.discover();
  const coverage = AgentPlugin.COVERAGE_LEVELS.standard;
  return defineConfig({
    plugins: [AgentPlugin({ console: { human: "stream", agent: "agent" }, coverageTargets: coverage.coverageTargets })],
    test: { ...(projects ? { projects } : {}), tags, coverage: { enabled: true, provider: "v8", thresholds: coverage.thresholds } },
  });
};

Documentation

Full guide, configuration reference and the Claude Code plugin docs live at vitest-agent.dev/guide.

License

MIT