Tests close to your code

Draft tests as your code changes.

Specwatch drafts JavaScript and TypeScript tests from source changes, then can run the generated file with Jest or Vitest. Ollama is the default model provider; cloud providers are optional. Review generated tests before relying on them.

Get Specwatch Read the installation guide

What you get

A source change can trigger generation and a test-file run. This is an illustrative test draft, not a recorded result:

// src/utils/auth.test.ts  (example)
describe('verifySession', () => {
  it('rejects expired tokens', () => {
    expect(verifySession(EXPIRED)).toBe(null);
  });
});

A passing runner result checks the file; it does not prove test quality or coverage improvement.

What it does

One job. A handful of deliberate commands.

Watch mode

specwatch watch

Watches JavaScript and TypeScript source files, generates a nearby test file, and can run it through Jest or Vitest.

One-shot generation

specwatch gen src/

Draft tests for a file, directory, or glob using detected conventions. Preview with gen --dry-run; existing tests are kept unless you pass --overwrite.

Maintenance

specwatch fix

Re-runs existing test files and regenerates failing ones from source. A failing test is only replaced by a candidate that passes.

Coverage

specwatch coverage

Reads an existing Istanbul coverage-final.json report and lists files below a statement threshold. JSON output is available.

Local first

specwatch.config.ts

Coverage reports and source analysis run on your machine. If you choose a cloud model for test generation, the selected source is sent to that provider.

CI integration

specwatch ci --coverage

Runs existing test files and optionally checks an existing coverage report. Missing or invalid coverage reports fail the gate before test execution.

The shape of it

Build, watch, and check.

01

Install
npm install --save-dev ./specwatch-0.1.0.tgz
Download the CLI archive below and install it in your JavaScript or TypeScript project with Jest or Vitest.
02

Watch
./node_modules/.bin/specwatch watch
On source changes, Specwatch asks the selected model for a test file and can run that file. Existing tests stay untouched unless you pass --overwrite, and a candidate only lands after it passes.
03

Check
./node_modules/.bin/specwatch ci --coverage
Run existing tests and check an existing Istanbul coverage report against a statement threshold. Missing or invalid measurements are setup errors; generate the report with your framework first.

Plays well with

VitestJestOllamaTypeScriptJavaScriptNode.js

Try it now

See the gaps before you write the tests.

Open the Istanbul report your Jest or Vitest run already produces. Specwatch ranks measured files by missed statements, functions and branches — the same order specwatch gen --coverage-gaps works through.

Your report stays in this browser tab. Coverage describes executed code; it does not measure the quality of your assertions.

Local tool · coverage

Find the next gap.

Open an Istanbul coverage-final.json and see which measured files need attention.

Your coverage report

Read in this tab. Nothing is uploaded or saved. Files absent from your report remain unknown.

Review your test drafts

A draft deserves a closer look.

Run Specwatch in your own project with Node.js, Jest or Vitest, and a model you choose. Local Ollama keeps model requests on your machine; optional cloud providers receive source context to draft tests.

Preview first

gen --dry-run previews a generated test. gen and watch keep existing test files unless you pass --overwrite; fix replaces a failing test only with a candidate that passes.

Check the report

Generate coverage with your test framework first. ci --coverage checks the existing Istanbul report and refuses missing or invalid measurements. Review assertion quality as well as coverage.

Start in your project

Draft, review, then run.

Use Node.js 22.12 or newer and your existing Jest or Vitest project. Test generation needs a running Ollama model or a configured cloud provider.

Download the CLI SHA-256 checksum Installation guide

npm install --save-dev ./specwatch-0.1.0.tgz
./node_modules/.bin/specwatch --help
./node_modules/.bin/specwatch gen src/example.ts --dry-run
./node_modules/.bin/specwatch ci --coverage --json

Run commands from your project folder. Generate an Istanbul coverage-final.json before using the coverage gate. Preview with --dry-run. Existing tests are kept unless you pass --overwrite, and repairs land only when the new test passes. Review each generated change.