# nvim-neotest/neotest

An extensible framework for interacting with tests within NeoVim.

Repository: https://github.com/nvim-neotest/neotest
Canonical: https://ross.abutalabs.com/products/neotest
Language: Lua
License: MIT
License Family: permissive
Topics: neovim, lua
Last push: 2026-08-16T15:42:23+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 94, longevity 100
- inputs: {"age_days": 1704, "days_push": 17, "days_rel": 40, "gap_med": 5.0, "n_releases_24m": 31}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3112, forks 186 (observed 2026-08-28T04:07:44.011965+00:00)

## What it is
Neotest is an extensible framework for interacting with tests inside NeoVim, providing test running, result display, diagnostics, and summary windows via adapters for various test runners. It is written in Lua and integrates with treesitter parsers and nvim-dap.

## Use cases
- run tests directly from neovim
- show test results as diagnostics in the editor
- browse and run individual tests from a summary window
- add support for a custom test runner in neovim
- debug tests inside neovim with nvim-dap

## When to choose
- you write and run tests inside NeoVim and want integrated results and navigation
- you need an extensible adapter-based test framework for many languages

## When to avoid
- you use an editor other than NeoVim
- you want a standalone CLI test runner rather than an in-editor framework

## Facets
- artifact type: plugin
- maturity: active
- function: testing, plugin-system, developer-tools
- domain: testing, developer-tools, text-editors
- platform: editor-plugin, windows
- tags: neovim, lua, test-runner, treesitter, extensible-framework, linux, macos

## Member repositories
- nvim-neotest/neotest (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:44.011965+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:26:42.577863+00:00, confidence not recorded.
  - readme: https://github.com/nvim-neotest/neotest (fetched 2026-08-28T04:07:44.011965+00:00, sha 075dc59bba67)
- Data as of 2026-08-30T08:39:29.467469+00:00.