nousdev

<h3 align="center">Adaptive documentation infrastructure</h3>

<p align="center"> <a href="https://opensource.org/licenses/MIT"></a> <a href="https://www.typescriptlang.org/"></a> <a href="https://nodejs.org/"></a> </p>

> Alpha. APIs may change between minor versions. Pin exact versions in production. Breaking changes are documented in the CHANGELOG.

---

Nous reads Markdown documentation and produces machine-readable outputs for LLMs, autonomous agents, RAG pipelines, and search engines. The pipeline infers semantic metadata from prose at build time and emits structured outputs across multiple agent-readability protocols. No new format to learn. No annotations required.

For teams that want a full documentation platform, Nous also ships an HTML renderer with a first-class design system (four theme presets, glassmorphic surfaces, depth tokens). Same source files, dual output: human-readable HTML and machine-readable agent metadata.

nous engine

Reads .md, .mdx, .kd, .adoc, .rst files. Infers annotations at build time and emits structured outputs without HTML rendering.

nous build

Everything the engine does, plus: HTML rendering, design system, full-text search, dev server with hot reload.

pnpm create nous my-docs
cd my-docs
pnpm nous dev          # full platform (HTML + agent outputs)
# or
pnpm nous engine       # pipeline only (agent outputs)

From plain .md files with zero configuration:

| Output | Protocol | Consumer | |--------|-------