Install

Every @flaky-tests/* package is published to both npm and JSR. Pick whichever registry fits your workflow — the code is identical.

A working setup needs exactly one runner plugin (plugin-bun or plugin-vitest) plus one store adapter (store-sqlite, store-turso, store-supabase, or store-postgres). The core package ships the CLI and is pulled in as a peer — install it explicitly if you want to run flaky-tests directly.

Not sure what to pick?

See Choosing a store for the store comparison, or jump to the Quick Start for an end-to-end walkthrough.

Core

The CLI + shared types. Installed automatically as a peer of every plugin, but you’ll want it explicitly if you run flaky-tests --html or flaky-tests --prompt from your own scripts.

npm

npm

npm i -D @flaky-tests/core

pnpm

pnpm add -D @flaky-tests/core

yarn

yarn add -D @flaky-tests/core

JSR

deno add jsr:@flaky-tests/core
npx jsr add @flaky-tests/core
bunx jsr add @flaky-tests/core
pnpm dlx jsr add @flaky-tests/core
yarn dlx jsr add @flaky-tests/core

Runner plugins

Pick one. These wire into your test runner and capture failures into the store.

@flaky-tests/plugin-bun

Bun test preload. Registers a global lifecycle hook and writes to the store via bun:sqlite.

npm

npm

npm i -D @flaky-tests/plugin-bun

pnpm

pnpm add -D @flaky-tests/plugin-bun

yarn

yarn add -D @flaky-tests/plugin-bun

JSR

deno add jsr:@flaky-tests/plugin-bun
bunx jsr add @flaky-tests/plugin-bun

See Setting up with Bun for the bunfig.toml preload step.

@flaky-tests/plugin-vitest

Vitest reporter implementing onInit / onFinished. Works with Vitest 1.x+.

npm

npm

npm i -D @flaky-tests/plugin-vitest

pnpm

pnpm add -D @flaky-tests/plugin-vitest

yarn

yarn add -D @flaky-tests/plugin-vitest

JSR

npx jsr add @flaky-tests/plugin-vitest
pnpm dlx jsr add @flaky-tests/plugin-vitest
yarn dlx jsr add @flaky-tests/plugin-vitest
bunx jsr add @flaky-tests/plugin-vitest

See Setting up with Vitest for the vitest.config.ts reporter registration.

Store adapters

Pick one. All adapters implement the same IStore interface, so swapping later only requires an environment variable change.

@flaky-tests/store-sqlite — local

Local libSQL / SQLite, runs on Node and Bun. Zero-config, perfect for local dev.

npm

npm

npm i -D @flaky-tests/store-sqlite

pnpm

pnpm add -D @flaky-tests/store-sqlite

yarn

yarn add -D @flaky-tests/store-sqlite

JSR

npx jsr add @flaky-tests/store-sqlite
pnpm dlx jsr add @flaky-tests/store-sqlite
yarn dlx jsr add @flaky-tests/store-sqlite
bunx jsr add @flaky-tests/store-sqlite

Details: SQLite store

@flaky-tests/store-turso — remote libSQL (free tier)

Turso/libSQL for shared team visibility without infrastructure to run.

npm

npm

npm i -D @flaky-tests/store-turso

pnpm

pnpm add -D @flaky-tests/store-turso

yarn

yarn add -D @flaky-tests/store-turso

JSR

npx jsr add @flaky-tests/store-turso
pnpm dlx jsr add @flaky-tests/store-turso
yarn dlx jsr add @flaky-tests/store-turso
bunx jsr add @flaky-tests/store-turso

Details: Turso store

@flaky-tests/store-supabase

Supabase-hosted Postgres via the Supabase client.

npm

npm

npm i -D @flaky-tests/store-supabase

pnpm

pnpm add -D @flaky-tests/store-supabase

yarn

yarn add -D @flaky-tests/store-supabase

JSR

npx jsr add @flaky-tests/store-supabase
pnpm dlx jsr add @flaky-tests/store-supabase
yarn dlx jsr add @flaky-tests/store-supabase
bunx jsr add @flaky-tests/store-supabase

Details: Supabase store

@flaky-tests/store-postgres — Postgres / Neon

Direct Postgres (Neon, RDS, self-hosted) via postgres.js.

npm

npm

npm i -D @flaky-tests/store-postgres

pnpm

pnpm add -D @flaky-tests/store-postgres

yarn

yarn add -D @flaky-tests/store-postgres

JSR

npx jsr add @flaky-tests/store-postgres
pnpm dlx jsr add @flaky-tests/store-postgres
yarn dlx jsr add @flaky-tests/store-postgres
bunx jsr add @flaky-tests/store-postgres

Details: Postgres / Neon store

Source links

Package	npm	JSR	Source
@flaky-tests/core	npmjs.com	jsr.io	packages/core
@flaky-tests/plugin-bun	npmjs.com	jsr.io	packages/plugin-bun
@flaky-tests/plugin-vitest	npmjs.com	jsr.io	packages/plugin-vitest
@flaky-tests/store-sqlite	npmjs.com	jsr.io	packages/store-sqlite
@flaky-tests/store-turso	npmjs.com	jsr.io	packages/store-turso
@flaky-tests/store-supabase	npmjs.com	jsr.io	packages/store-supabase
@flaky-tests/store-postgres	npmjs.com	jsr.io	packages/store-postgres