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.
type | Categoría en la tienda | Obligatorio en contributes | Se ejecuta en |
|---|---|---|---|
theme | Temas | themes | Ingot |
rules | Paquetes de reglas | rules | Ingot |
habits | Paquetes de Habits | habits | Ingot |
mcp | Servidores MCP | mcpServers | Ingot |
rex-template | Plantillas de Rex | rexTemplates | Zaprex |
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" }]
}
uiThemeesdarkolight; 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
}
| Campo | Notas |
|---|---|
id | palabras en minúsculas unidas con - |
title | qué detecta el patrón, hasta 120 caracteres |
match | una expresión regular de JavaScript que se prueba contra las líneas rechazadas |
rule | el texto de la regla que sugiere Habits (hasta 2.000 caracteres) |
threshold | opcional: 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.envlista 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 trymuestra 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 defiles). - El servidor de inicio de
ingot init --type mcpes un servidor stdio sin dependencias con una herramienta; ejecutanode server/index.mjspara 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 extrahabits: patrones de Habits extracommands: comandos de barra, prompts en Markdown que se convierten en/<nombre>en el chat del agentemcpServers: 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.