Tipos de extensión

La tienda de Ingot acepta cinco tipos de extensiones. Cada ingot.json tiene un type, que decide la categoría en la tienda y qué entrada de contributes es obligatoria; además, un paquete puede añadir reglas, habits, comandos y servidores MCP.

typeCategoría en la tiendaObligatorio en contributesSe ejecuta en
themeTemasthemesIngot
rulesPaquetes de reglasrulesIngot
habitsPaquetes de HabitshabitsIngot
mcpServidores MCPmcpServersIngot
rex-templatePlantillas de RexrexTemplatesZaprex

Crea cualquiera con ingot init <carpeta> --type <tipo> y sigue la guía para creadores.

Tema de color

Un tema de color en el formato JSON de temas estándar, con colors (interfaz) y/o tokenColors (sintaxis). Ingot lo muestra en Ajustes › Apariencia › Tema.

"contributes": {
  "themes": [{ "id": "acme-dark", "label": "Acme Dark", "uiTheme": "dark", "path": "themes/acme-dark.json" }]
}
  • uiTheme es dark o light; Ingot lo usa para todo lo que el tema no colorea.
  • Un paquete puede tener una variante oscura y otra clara: añade dos entradas.
  • Prueba: ingot try <proyecto> y elige el tema en Ajustes.

Paquete de reglas

Archivos Markdown (.md) o .mdc para la carpeta .ingot/rules/ del proyecto. El agente los lee en cada petición que coincide (ver Reglas).

---
description: Convenciones de React
globs: "**/*.{ts,tsx}"
alwaysApply: false
---

- Prefiere exportaciones con nombre a las exportaciones por defecto.
- Pon un test junto a cada componente.

Añade más archivos con ingot add rule <nombre>. Escribe reglas cortas y concretas: el agente sigue mejor "Usa zod para validar las peticiones" que "Valida bien la entrada".

Paquete de Habits

Habits observa las ediciones del agente que rechazas. Cuando el mismo patrón aparece suficientes veces, sugiere una regla. Un paquete de Habits trae patrones listos, un archivo JSON por patrón:

{
  "id": "no-console-log",
  "title": "Ediciones rechazadas que añaden console.log",
  "match": "console\\.log\\(",
  "rule": "- No añadas llamadas a console.log. Usa el logger del proyecto.",
  "threshold": 3
}
CampoNotas
idpalabras en minúsculas unidas con -
titlequé detecta el patrón, hasta 120 caracteres
matchuna expresión regular de JavaScript que se prueba contra las líneas rechazadas
ruleel texto de la regla que sugiere Habits (hasta 2.000 caracteres)
thresholdopcional: cuántos rechazos antes de que Habits sugiera la regla, de 1 a 20

Añade uno con ingot add habit <id> --match "<regex>" --rule "<texto>". La tienda rechaza un habit cuyo match no es una expresión regular válida.

Servidor MCP

Un servidor MCP le da herramientas nuevas al agente. Un paquete declara uno o más servidores en mcpServers; Ingot los escribe en .ingot/mcp.json (ver Servidores MCP).

Un servidor local incluido en el paquete:

"files": ["server"],
"contributes": {
  "mcpServers": {
    "word-tools": { "command": "node", "args": ["${extensionDir}/server/index.mjs"] }
  }
}

Un servidor de npm que necesita una clave de API:

"mcpServers": {
  "acme": { "command": "npx", "args": ["-y", "@acme/mcp-server"], "env": { "ACME_API_KEY": "Tu clave de la API de Acme (Ajustes › API)" } }
}

Un servidor remoto: { "url": "https://mcp.acme.dev/sse" }.

  • ${extensionDir} se sustituye por la carpeta donde se instala la extensión.
  • env lista nombres de variables con una descripción de lo que hay que escribir, nunca el valor. Los valores quedan vacíos al instalar el servidor y el usuario los rellena (ingot try muestra cuáles hay que definir). Nunca pongas una clave real en el paquete.
  • El código que necesita el servidor debe estar en files (solo se empaquetan los archivos referenciados y las entradas de files).
  • El servidor de inicio de ingot init --type mcp es un servidor stdio sin dependencias con una herramienta; ejecuta node server/index.mjs para probarlo.

Plantilla de Rex

Trabajo que Rex, el agente en la nube de Zaprex, ejecuta por ti en un sandbox: un archivo Markdown con frontmatter opcional (title, schedule como expresión cron) y las instrucciones en el cuerpo.

---
title: Arreglo nocturno de tests
schedule: "0 3 * * 1-5"
---

Ejecuta los tests. Si alguno falla, corrige la causa con el cambio más pequeño y abre un pull request.

Las plantillas de Rex aparecen en la parte de Zaprex de la tienda. Para ejecutarlas hace falta un plan de Zaprex con Rex (precios).

Combinar tipos

Cualquier tipo puede llevar además:

  • rules: archivos de reglas extra
  • habits: patrones de Habits extra
  • commands: comandos de barra, prompts en Markdown que se convierten en /<nombre> en el chat del agente
  • mcpServers: servidores que necesita la extensión

Por ejemplo, un paquete rules para un framework puede añadir un comando /migrate y el servidor MCP del framework. Todos los campos están en Manifiesto.