Plugin

Monorepo for the vitest-agent package family — a Vitest plugin, reporter, CLI, MCP server and Claude Code plugin that turn a test run into structured intelligence for LLM coding agents. It produces shape-tailored console output, persists every run to SQLite at an XDG-derived path and exposes test status, coverage, failure history and trends over a CLI and an MCP server.

User documentation lives at vitest-agent.dev. This README is the developer-facing hub for working in the repo itself.

Packages

The seven publishable packages live under packages/. @vitest-agent/sdk has no internal dependencies; the dependency flow is plugin → reporter → ui → sdk, with the sidecar reaching consumers through the CLI.

The sidecar's per-platform binaries ship as optionalDependencies from four sub-packages — @vitest-agent/sidecar-darwin-arm64, -linux-arm64, -linux-x64 and -win32-x64 under packages/sidecar-*/. The six original packages release in lockstep; @vitest-agent/sidecar versions independently.

@vitest-agent/plugin ships @vitest-agent/cli and @vitest-agent/mcp as exact-pinned regular dependencies, so a single npm install @vitest-agent/plugin pulls the whole family on any package manager.

Private workspaces

The Claude Code plugin lives at plugin/ and is a file-based plugin, not a pnpm workspace — a directory of markdown, JSON, shell and a zero-deps Node loader consumed by the Claude Code plugin system. See plugin/README.md.

Entry points

All three share the Effect service architecture and the same SQLite database, located under $XDG_DATA_HOME/vitest-agent/<workspaceKey>/data.db where <workspaceKey> derives from the root package.json name.

Requirements

• Node.js (this repo pins a version via devEngines)
• pnpm (this repo pins a version via packageManager)

Development

pnpm install
pnpm run build
pnpm run test
pnpm run lint
pnpm run typecheck

To scope a command to one package, use a Turbo filter:

turbo run build:dev build:prod --filter='./packages/sdk'

Contributors: see CONTRIBUTING.md for the full setup, commit and code-quality workflow, and docs/dogfooding.md for testing the system against its own playground.

Documentation

User-facing documentation — installation, configuration, the CLI and MCP reference, the Claude Code plugin and per-package guides — lives at vitest-agent.dev. The site source is the website workspace.

License

MIT