Skip to content
Limited Edition DevTools

DecisionLint

Lint Jev and Luna questions before they are sent: the questions you write for TypeSafe's Jev, OpenAI's Decisions API (gpt-6-luna) or any platform that serves one, as you type, with no API key and no network calls. An optional command asks the model itself to check a file

FreeOpen sourceMITLints offline · asks the model only when you do

No editor in the loop? npx -y decisionlint-mcp runs the same engine as an MCP server, so an agent can call lint_text with nothing else installed. Every way to install it.

Overview

What DecisionLint does

Jev and Luna answer the question you wrote, which is not always the one you meant. DecisionLint finds the questions a project sends to a decision model, TypeSafe's Jev, OpenAI's Decisions API or any platform that serves either shape, from OpenRouter and Vercel AI Gateway to a llama.cpp on your own machine, in JSON, JavaScript, TypeScript, Python, Rust and Go, and reports the ones written in a way measured to produce bad answers: a choice with no fallback option, a score given a map where it takes a list, a type that does not exist, a question that turns on a word with no stated line. The limits a request is held to are the platform's own, read from the model id, a URL in the file or a target setting. Linting runs as you type with no API key and no network. A part of a question that is built at runtime is counted as not read, never guessed at. Two optional commands, run by you with your own key at whichever platform you send to, ask the model itself whether a file's questions have problems a text pattern cannot see, or re-send one question with its layout changed to see whether the answer holds.

What people use it for

  • Catch it while typing

    Findings appear in the editor as a question is written, with a quick fix where the fix is not a guess.

  • Check a pull request

    The same checks run from the command line, with output for a terminal, as JSON, or as GitHub annotations.

  • Hand it to an agent

    The MCP server offers lint_text, lint_paths and list_rules, so an agent can check the questions it writes.

Palette

19 commands

Open the command palette and type the name. Nothing is bound to a shortcut by default — the editor's keymap is the user's, not ours.

  • Lint the Questions in This Filedecisionlint.lintFile
  • Lint the Questions in the Workspacedecisionlint.lintWorkspace
  • Open Settingsdecisionlint.openSettings
  • Ask Jev About This File (TypeSafe, uses your API key)decisionlint.askJev
  • Ask Luna About This File (OpenAI, uses your API key)decisionlint.askLuna
  • Ask via OpenRouter About This File (uses your API key)decisionlint.askOpenRouter
  • Ask via Vercel AI Gateway About This File (uses your API key)decisionlint.askVercel
  • Ask via LLM Gateway About This File (uses your API key)decisionlint.askLlmGateway
  • Ask Liquid d1 About This File (uses your API key)decisionlint.askLiquid
  • Ask the Model at My Endpoint About This Filedecisionlint.askEndpoint
  • Set TypeSafe API Keydecisionlint.setTypeSafeApiKey
  • Set OpenAI API Keydecisionlint.setOpenAIApiKey
  • Set OpenRouter API Keydecisionlint.setOpenRouterApiKey
  • Set Vercel AI Gateway API Keydecisionlint.setVercelApiKey
  • Set LLM Gateway API Keydecisionlint.setLlmGatewayApiKey
  • Set Liquid AI API Keydecisionlint.setLiquidApiKey
  • Set Endpoint API Keydecisionlint.setEndpointApiKey
  • Clear API Keysdecisionlint.clearApiKeys
  • Probe the Question at the Cursor (asks Jev, uses your TypeSafe key)decisionlint.probeQuestion

Rules

37 rules

Each code links to its page: what it catches, an example, and how to fix or silence it.

Requests Read from the text, offline.

  • DEC000unreadablehint

    Part of the question is built at runtime, so the rules that need it did not run

  • DEC001unpinned-modelwarning

    An alias such as jev-latest moves with each release, so answers can change with no change on your side

  • DEC002choice-option-limiterror

    A Choice has more than 255 options. The API rejects it

  • DEC003score-level-limiterror

    A Score has more than 10 levels. The API rejects it

  • DEC004no-fallback-optioninfo

    A Choice has no other or none of the above, so an input that fits no option is forced into one. The largest cost measured anywhere, and the hardest to tell from text

  • DEC005duplicateerror

    A question id, option or level appears twice. In an object the later one silently replaces the earlier

  • DEC006criteria-shapeerror

    A Choice needs a map of options, a Score needs an array of levels, and a Noul takes true and false

  • DEC007invalid-questionerror

    The type is missing or unknown, or the instructions are an empty string

  • DEC008numeric-levelsinfo

    Score levels are bare numbers. Jev matches the state against each description and never sees its position

  • DEC009too-few-optionsinfo

    A Choice with one option or a Score with one level gives every input the same answer

  • DEC010unused-disablewarning

    A decisionlint-disable comment silences nothing, so it can only hide a finding added later

  • DEC011description-repeats-nameinfo

    An option's description only repeats its name, or a Noul's criteria say yes and no. Jev matches the state against the description, and this one says nothing

  • DEC012terse-instructionswarning

    The instructions are one or two words, so the question leans on its id. Jev is sent the instructions and never the id

  • DEC013newer-modelinfo

    model names a Jev version newer than the one these rules were measured on, so a finding may cost nothing there and a weakness new to it is not looked for

  • DEC014question-limiterror

    A request has more questions than the platform it goes to takes in one call. The platform rejects it

Wording Read from the text, offline.

  • DEC101double-negativeinfo

    A question negates twice in one clause, or a negation sits directly on another

  • DEC102arithmeticwarning

    The question asks Jev to count or compare numbers

  • DEC103date-comparisonwarning

    The question asks Jev to order two times or measure the gap between them

  • DEC104compoundoff by default

    A Noul joins two judgments with 'and'

  • DEC105generationwarning

    The question asks for a value or for text to be written

  • DEC107negated-nouloff by default

    A Noul with no criteria is phrased so that yes means something is absent

  • DEC108inverted-criteriaoff by default

    A Noul's 'true' criterion describes the negative case

  • DEC110degree-levelsoff by default

    Score levels are degree words, bare labels, or one word turned up and down. Nothing for Jev to match the state against

  • DEC111numeric-encodingoff by default

    The question refers to a value by hex or RGB encoding

  • DEC112undefined-boundaryoff by default

    A Noul with no criteria turns on a word such as large, often or enough

Asked of the model Run only when you ask, with your own key.

  • DEC301model-countingwarning

    Jev reads the question as needing counting or arithmetic

  • DEC302model-undefined-boundaryinfo

    Jev reads a Noul as turning on a matter of degree with no stated line

  • DEC303model-overlapping-optionsinfo

    Jev reads two options of a Choice as covering the same cases

  • DEC304model-overlapping-levelswarning

    Jev reads two levels of a Score as the same situation

  • DEC305model-label-mismatchwarning

    Jev reads an option as named for one thing and described as another

  • DEC306model-criteria-off-topicinfo

    Jev reads the criteria as deciding something the instructions do not ask

  • DEC307model-ordered-optionsinfo

    Jev reads a Choice's options as steps on one scale, which a Score would place between

  • DEC308model-unordered-levelsinfo

    Jev reads a Score's levels as unordered categories, which a Choice would pick from

  • DEC309model-depends-on-siblinginfo

    Jev reads a question as needing another question's answer from the same request

  • DEC310model-overlapping-questionsinfo

    Jev reads two questions in one request as asking for the same judgment

  • DEC311model-answer-not-in-stateinfo

    Jev reads the state written in the file as not holding what the question asks about

  • DEC312model-orders-in-stateinfo

    Jev reads part of the state written in the file as giving orders to its reader

Install

Install DecisionLint

VS Code

ext install nolindnaidoo.decisionlint

Open Quick Open (Cmd/Ctrl+P) and paste.

Cursor / Windsurf

cursor --install-extension nolindnaidoo.decisionlint

Cursor, Windsurf, VSCodium and the other VS Code forks pull from Open VSX. The id is the same as on the Marketplace.

AI agents

npx -y decisionlint-mcp

Runs DecisionLint's engine as an MCP server, so an agent can call lint_text with no editor involved. VS Code 1.101+ needs nothing — the extension registers it for you.

Channels

Where it ships

One engine, 4 places to get it. Copy the one for the editor you use.

Links

Where DecisionLint lives

The family

The other 16