Consume as a library

WritingLint is a library first, a demo second. The engine lives in writinglint-core; the parser loader for Node is writinglint-parser-node; the AI-writing rules and scorer are in writinglint-rulepack-ai-style.

Install

npm install writinglint-core writinglint-parser-node writinglint-rulepack-ai-style
# the parser needs the model once (~145 MB):
npx nlpgraph download --model xsmall --dir ./models

A runnable version of everything below is in examples/node-lint.

Lint some text

new Linter(parser).lint(text, config) parses the text once and runs every enabled rule in a single walk. It returns the document, the flat list of Lints, and the category metadata for the rules that ran.

import { Linter } from 'writinglint-core';
import { loadParser } from 'writinglint-parser-node';
import { recommended } from 'writinglint-rulepack-ai-style';

const linter = new Linter(await loadParser({ modelDir: './models/xsmall' }));

const { lints } = await linter.lint(
  "It's not just a linter, it's a paradigm shift.",
  recommended,
);

for (const l of lints) {
  console.log(`${l.ruleId}  [${l.category}]  ${l.start}-${l.end}  ${l.message}`);
  // ai-style/corrective-antithesis  [parallelism]  8-46  Corrective antithesis …
}

Each Lint carries everything a UI needs: ruleId, category, severity, the start/end char offsets into the original text, the exact text flagged, and a plain-language message (plus an optional fix/suggestion).

Pick and tune rules

recommended turns on every ai-style rule at warn. To narrow or retune, build a config with defineConfig — ESLint-flat-config style: extends pulls in presets, rules overrides ('off' | 'warn' | 'error').

import { defineConfig } from 'writinglint-core';
import { recommended } from 'writinglint-rulepack-ai-style';

const config = defineConfig({
  extends: [recommended],
  rules: {
    'ai-style/markdown-bold': 'off',        // linting Markdown — silence format artifacts
    'ai-style/corrective-antithesis': 'error',
  },
});

const { lints } = await linter.lint(text, config);

Score how AI-shaped it reads (optional)

The stylometric score is separate from the lints by design — it’s a document-level metric, not a rule. Load the shipped, data-free model and call score(doc, lints, model):

import { score } from 'writinglint-rulepack-ai-style';
import { loadModelNode } from 'writinglint-rulepack-ai-style/node';

const model = await loadModelNode();
const { doc, lints } = await linter.lint(text, recommended);
const { score: s, verdict } = score(doc, lints, model);
console.log(`${s}/100 — reads as ${verdict}`);

In the browser

The engine is isomorphic. In the browser, swap loadParser() for a parser built on nlpgraph/browser (onnxruntime-web on WASM) and run the whole thing in a Web Worker so long documents don’t block the UI thread — that’s exactly what this site’s live demo does.