# danymat/neogen

A better annotation generator. Supports multiple languages and annotation conventions.

Repository: https://github.com/danymat/neogen
Canonical: https://ross.abutalabs.com/products/neogen
Language: Lua
License: GPL-3.0
License Family: copyleft
Topics: neovim, neovim-plugin, neovim-annotation, neovim-documentation, nvim, neovim-lua, annotation, lua, comment
Last push: 2026-01-10T18:00:38+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 61, release rhythm 35, longevity 100
- inputs: {"age_days": 1844, "days_push": 235, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1659, forks 74 (observed 2026-08-28T04:05:18.333226+00:00)

## What it is
Neogen is a Neovim plugin written in Lua that generates code annotations (docstrings/comments) for functions, classes, types, and files using Tree-sitter. It supports multiple languages and annotation conventions, with cursor jumping inside inserted annotations.

## Use cases
- generate docstrings for functions in neovim
- auto-generate code annotations with one keybind
- add jsdoc-style comments to my code
- generate python docstrings automatically
- create class and file annotations in multiple languages
- customize annotation templates for my team's conventions

## When to choose
- you use Neovim and want fast, customizable annotation generation
- you work across multiple languages and annotation styles
- you want Tree-sitter-based accuracy for locating functions and classes

## When to avoid
- you don't use Neovim
- your language or annotation convention is unsupported
- you need an IDE-integrated documentation generator outside the terminal

## Facets
- artifact type: plugin
- maturity: active
- function: documentation, developer-tools, editor
- domain: developer-tools, documentation, text-editors
- platform: editor-plugin, cli, cross-platform
- tags: neovim, annotations, tree-sitter, docstrings, lua, code-comments

## Member repositories
- danymat/neogen (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.333226+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-30T03:44:41.815200+00:00, confidence not recorded.
  - readme: https://github.com/danymat/neogen (fetched 2026-08-28T04:05:18.333226+00:00, sha ce531019d977)
- Data as of 2026-08-30T08:39:29.467469+00:00.