# Kiira

By **alemtuzlak** · Software & Tools

Verifica los tipos del código TypeScript y JavaScript en tus documentos Markdown y MDX contra la API real de tu proyecto, en tu editor, la CLI y CI, para que los ejemplos documentados nunca queden desactualizados ni sean alucinados.

- Source: https://github.com/AlemTuzlak/kiira
- Repository: https://github.com/AlemTuzlak/kiira
- Install: `npx kiira`
- Tags: cli, open-source, typescript, documentation, dx, ci, vscode, monorepo
- Pricing: free
- Upvotes: 0

## Features

- Verifica los tipos de los bloques de código TS y JS en Markdown y MDX contra la API real de tu proyecto.
- Reporta errores de forma integrada en tu editor, la CLI y CI.
- Resolución de monorepo con workspace awareness sin rutas tsconfig escritas a mano.
- Sobreescrituras de compilador por glob para documentación multisistema.
- Agrupación de fragmentos para tutoriales de múltiples bloques.
- Modo de corrección automática que reescribe bloques mal etiquetados y añade etiquetas de agrupación.
- Se distribuye como biblioteca central, CLI, extensión de VS Code y GitHub Action.

---

Kiira extrae los bloques de código TypeScript y JavaScript de tu documentación Markdown y MDX, y verifica sus tipos contra la API real de tu proyecto. Reporta los errores directamente en la línea fuente correspondiente: en tu editor, en la línea de comandos y en CI. Existe porque los documentos los escriben y actualizan cada vez más agentes de IA que alucinan APIs, y Kiira detecta exactamente lo que hace fallar un ejemplo copiado y pegado: importaciones inválidas, exportaciones faltantes, subrutas de paquete incorrectas, nombres de función o prop equivocados, y código que simplemente no compila.

Es compatible con workspaces en monorepos, mapeando cada paquete a su fuente para que las importaciones internas `@scope/*` se resuelvan sin rutas tsconfig escritas a mano. Admite sobreescrituras de compilador por glob para documentación multisistema, y agrupa fragmentos que se construyen unos sobre otros. Un modo `--fix` reescribe los bloques mal etiquetados, añade etiquetas de agrupación y escribe las sobreescrituras de framework por ti. Kiira se distribuye como una biblioteca central, una CLI `kiira`, una extensión de VS Code para subrayados en tiempo real dentro de los bloques, y una GitHub Action para CI.

## FAQ

### ¿Qué problema resuelve Kiira?

Mantiene correctos los ejemplos de código en tu documentación verificando sus tipos contra la API real de tu proyecto, para que las importaciones, exportaciones y nombres de opciones no puedan quedar desactualizados en silencio ni ser alucinados por un agente de IA.

### ¿Dónde puede ejecutarse Kiira?

En tu editor (una extensión de VS Code muestra subrayados en tiempo real dentro de los bloques Markdown), en la línea de comandos mediante kiira check, y en CI a través de la GitHub Action incluida.

### ¿Funciona Kiira en monorepos?

Sí. En modo workspace descubre tu workspace de pnpm, npm o yarn y mapea cada paquete a su fuente, de modo que los documentos que importan tus paquetes internos y bibliotecas de terceros se resuelven sin rutas tsconfig escritas a mano.

---
[View on Analog](https://analoghq.ai/es/alemtuzlak/software-tools/kiira)